> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.idenfy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Government Registry

> Access government registry data for company verification and compliance checks using the iDenfy KYB government registers search API.

<Note>
  **Requirements**

  * **API** key pair
  * Reports functionality **enabled** (done by iDenfy's staff)
</Note>

<Info>
  **Sample reports:** [Download here](/images/preview/ReportSamples.zip)
</Info>

***

The Government Registry API lets you search for companies across 100+ countries and order detailed company reports sourced directly from official government registries. Use it to verify company existence, retrieve registration details, and download structured reports.

## GOV Registry

### Search

<Info>
  **Authorization:** `API key pair`
  **Method:** `GET`
  **Endpoint:** `https://ivs.idenfy.com/api/v2/gov-registers-documents/search/`
</Info>

<Note>
  If `company_name` is not provided, all countries `country_code` are available, except: BD, BR, FI, ID, MA, NI, OM, PH, TT and US-IL, US-NY, US-SC.
</Note>

| Parameter (query) | Type   | Required        | Sample/available values                    |
| ----------------- | ------ | --------------- | ------------------------------------------ |
| `company_name`    | String | No              | "Mycompany", check note above              |
| `country_code`    | String | Yes             | 2-digit ISO country code, check note above |
| `registry_number` | String | No              | "12511182"                                 |
| `region`          | String | For US & Canada | 2-digit ISO state code                     |

**Response example**

```json theme={"system"}
{
  "addressesField": [
    {
      "countryField": "LT",
      "typeField": "registered",
      "typeCodeField": "REG",
      "addressInOneLineField": "Vilniaus g. 31, LT-01402 Vilnius",
      "addressLine1Field": "Vilniaus g. 31",
      "addressLine2Field": "",
      "addressLine3Field": "",
      "addressLine4Field": "",
      "addressLine5Field": "",
      "postcodeField": "LT-01402",
      "cityTownField": "Vilnius",
      "regionStateField": "Vilniaus m. sav.",
      "websiteUrlField": "https://example.lt",
      "emailField": "info@example.lt",
      "faxNumberField": "",
      "telephoneNumberField": "+37052000000",
      "PropertyChanged": ""
    }
  ],
  "aliasesField": {},
  "codeField": "305216619",
  "companyIDField": "305216619",
  "dateField": "2020-03-15",
  "legalFormField": "UAB",
  "legalStatusField": "Active",
  "nameField": "UAB Pavyzdinė Įmonė",
  "officialField": true,
  "registrationAuthorityField": "Juridinių asmenų registras",
  "registrationAuthorityCodeField": "LTRC",
  "sourceField": "Registrų centras",
  "virtualIDField": "LT-305216619",
  "moreKeyField": "",
  "functionField": "",
  "PropertyChanged": ""
}
```

***

### Order GOV Registers Company Report

<Info>
  **Authorization:** `API key pair`
  **Method:** `POST`
  **Endpoint:** `https://ivs.idenfy.com/api/v2/gov-registers-documents/report/`
</Info>

<Note>
  If the request is for USA or Canada, add an additional parameter `region` with a state in alpha-2 format, e.g. `"region": "CA"`.
</Note>

<Tabs>
  <Tab title="Request">
    ```json theme={"system"}
    {
      "countryCode": "AF",
      "companyName": "string",
      "registryNumber": "string"
    }
    ```
  </Tab>

  <Tab title="Response">
    ```json theme={"system"}
    {
      "dataFile": "JSON file URL",
      "reportFile": "PDF file URL",
      "id": "string"
    }
    ```
  </Tab>
</Tabs>

***

### Retrieve Specific GOV Registry Document

<Info>
  **Authorization:** `API key pair`
  **Method:** `GET`
  **Endpoint:** `https://ivs.idenfy.com/api/v2/gov-registers-documents/{id}/`
  **{id}:** `Report's unique number`
</Info>

**Response sample**

```json theme={"system"}
{
  "id": "string",
  "externalCompanyId": "string",
  "checkedAt": "2022-06-30T10:08:00.701Z",
  "dataFile": "JSON",
  "reportFile": "PDF",
  "companyName": "string",
  "postcode": "string",
  "city": "string",
  "activityCode": "string",
  "activity": {
    "additionalProp1": "string",
    "additionalProp2": "string",
    "additionalProp3": "string"
  },
  "addresses": {
    "additionalProp1": "string",
    "additionalProp2": "string",
    "additionalProp3": "string"
  },
  "aliases": {
    "additionalProp1": "string",
    "additionalProp2": "string",
    "additionalProp3": "string"
  },
  "email": "string",
  "faxNumber": "string",
  "telephoneNumber": "string",
  "fiscalCode": "string",
  "websiteUrl": "string",
  "foundationDate": "string",
  "legalForm": "string",
  "legalStatus": "string",
  "registrationAuthority": "string",
  "registrationAuthorityCode": "string",
  "registrationDate": "string",
  "registrationNumber": "string",
  "vatNumber": "string",
  "stateOfIncorporation": "string",
  "associatedPersons": {
    "additionalProp1": "string",
    "additionalProp2": "string",
    "additionalProp3": "string"
  }
}
```

***

### Retrieve All GOV Register Documents

<Info>
  **Authorization:** `API key pair`
  **Method:** `GET`
  **Endpoint:** `https://ivs.idenfy.com/api/v2/gov-registers-documents/`
</Info>

Use the `checked_at` query parameter if a date range is needed. The type for the parameter is `array[string]`.

**Response sample**

```json theme={"system"}
[
  {
    "id": "string",
    "externalCompanyId": "string",
    "checkedAt": "2022-06-30T10:23:49.511Z",
    "dataFile": "json",
    "reportFile": "pdf",
    "companyName": "string",
    "postcode": "string",
    "city": "string",
    "activityCode": "string",
    "activity": {
      "additionalProp1": "string",
      "additionalProp2": "string",
      "additionalProp3": "string"
    },
    "addresses": {
      "additionalProp1": "string",
      "additionalProp2": "string",
      "additionalProp3": "string"
    },
    "aliases": {
      "additionalProp1": "string",
      "additionalProp2": "string",
      "additionalProp3": "string"
    },
    "email": "string",
    "faxNumber": "string",
    "telephoneNumber": "string",
    "fiscalCode": "string",
    "websiteUrl": "string",
    "foundationDate": "string",
    "legalForm": "string",
    "legalStatus": "string",
    "registrationAuthority": "string",
    "registrationAuthorityCode": "string",
    "registrationDate": "string",
    "registrationNumber": "string",
    "vatNumber": "string",
    "stateOfIncorporation": "string",
    "associatedPersons": {
      "additionalProp1": "string",
      "additionalProp2": "string",
      "additionalProp3": "string"
    }
  }
]
```