> For the complete documentation index, see [llms.txt](https://docs.transactionlink.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.transactionlink.io/docs/v1/integrations/gus.md).

# GUS

## Regon

### Input

```json
{
    "nip": "5224158027" 
}
```

### Response Content

**gus**

| Attribute           | Type     | Description  |
| ------------------- | -------- | ------------ |
| [`regon`](#regon-1) | `object` | Regon result |

#### regon

<table><thead><tr><th width="257">Attribute</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td><code>regon</code></td><td><code>string</code></td><td>National Business Registry Number</td></tr><tr><td><code>nip</code></td><td><code>string</code></td><td>Tax Identification Number</td></tr><tr><td><a href="#krs"><code>krs</code></a></td><td><code>object</code></td><td>National Court Register</td></tr><tr><td><code>endDate</code></td><td><code>string</code></td><td>End date of business activity</td></tr><tr><td><code>phone</code></td><td><code>string</code></td><td>Phone number</td></tr><tr><td><code>email</code></td><td><code>string</code></td><td>Email address</td></tr><tr><td><code>firstName</code></td><td><code>string</code></td><td>First name</td></tr><tr><td><code>secondName</code></td><td><code>string</code></td><td>Second name</td></tr><tr><td><code>surname</code></td><td><code>string</code></td><td>Surname</td></tr><tr><td><code>companyName</code></td><td><code>string</code></td><td>Company name</td></tr><tr><td><code>creationDate</code></td><td><code>string</code></td><td>Creation date of business activity</td></tr><tr><td><code>startDate</code></td><td><code>string</code></td><td>Start date of business activity</td></tr><tr><td><code>legalForm</code></td><td><code>string</code></td><td>Legal form of company</td></tr><tr><td><a href="#address"><code>address</code></a></td><td><code>object</code></td><td>Address of company</td></tr><tr><td><code>type</code></td><td><code>string</code></td><td>Type of company. P or F</td></tr><tr><td><code>activityCeidg</code></td><td><code>boolean</code></td><td>Is business registered in the Central Register and Information on Business Activity (CEIDG)</td></tr><tr><td><code>activityAgricultural</code></td><td><code>boolean</code></td><td>Is business agricultural</td></tr><tr><td><code>activityOther</code></td><td><code>boolean</code></td><td>Is business registered in other registers</td></tr></tbody></table>

#### krs

| Field               | Type     | Description                                    |
| ------------------- | -------- | ---------------------------------------------- |
| `krsNumber`         | `string` | National Court Register number                 |
| `krsInsertDate`     | `string` | Date of entry in National Court Register       |
| `krsFirstEntryDate` | `string` | Date of first entry in National Court Register |

#### address

| Field     | Type     | Description    |
| --------- | -------- | -------------- |
| `country` | `string` | Country        |
| `city`    | `string` | City or town   |
| `postal`  | `string` | Postal code    |
| `street`  | `string` | Street address |

#### Example response

```json
{
  "gus": {
    "regon":{
        "regon": "385349514",
        "nip": "5252812929",
        "krs": {
            "krsNumber": "0000823971",
            "krsInsertDate": "2020-01-16",
            "krsFirstEntryDate": "2020-01-16"
        },
        "endDate": "",
        "phone": "500123123",
        "email": "test@transactionlink.io",
        "companyName": "TRANSACTIONLINK SPÓŁKA Z OGRANICZONĄ ODPOWIEDZIALNOŚCIĄ",
        "creationDate": "2020-01-16",
        "startDate": "2020-01-16",
        "legalForm": "SPÓŁKI Z OGRANICZONĄ ODPOWIEDZIALNOŚCIĄ",
        "address": {
            "country": "POLSKA",
            "city": "Warszawa",
            "postal": "00-229",
            "street": "Rynek Nowego Miasta 9/9"
        },
        "type": "P",
        "activityCeidg": false,
        "activityAgricultural": false,
        "activityOther": false
    }   
  }
}
```

```json
{
    "gus":{
        "regon":{
            "regon":"368638855",
            "nip":"6572714838",
            "krs":{
                "krsNumber":"001671117/2017",
                "krsInsertDate":"2017-10-31",
                "krsFirstEntryDate":"2017-10-31"
            },
            "endDate":"",
            "phone":"",
            "email":"",
            "firstName":"ADAM",
            "secondName":"SŁAWOMIR",
            "surname":"GĘBAL",
            "companyName":"Adam Gębal Consulting",
            "creationDate":"2017-10-31",
            "startDate":"2017-11-02",
            "legalForm":"OSOBY FIZYCZNE PROWADZĄCE DZIAŁALNOŚĆ GOSPODARCZĄ",
            "address":{
                "country":"POLSKA",
                "city":"Kielce",
                "postal":"25-370",
                "street":"ul. Stefana Żeromskiego 29/64"
            },
            "type":"F",
            "activityCeidg":true,
            "activityAgricultural":false,
            "activityOther":false
        }
    }
}
```