Government Registry

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

Requirements

• API key pair
• Reports functionality enabled (done by iDenfy’s staff)

---

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

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

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.

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

{
  "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": "[e-mail]",
      "faxNumberField": "",
      "telephoneNumberField": "[phone]",
      "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

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

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

Request

{
  "countryCode": "AF",
  "companyName": "string",
  "registryNumber": "string"
}

Response

{
  "dataFile": "JSON file URL",
  "reportFile": "PDF file URL",
  "id": "string"
}

---

Retrieve Specific GOV Registry Document

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

Response sample

{
  "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

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

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

Response sample

[
  {
    "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"
    }
  }
]