Skip to main content

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.

Requirements
  • API key pair
  • Reports functionality enabled (done by iDenfy’s staff)
Sample reports: Download here
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

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)TypeRequiredSample/available values
company_nameStringNo”Mycompany”, check note above
country_codeStringYes2-digit ISO country code, check note above
registry_numberStringNo”12511182”
regionStringFor US & Canada2-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": "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

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".
{
  "countryCode": "AF",
  "companyName": "string",
  "registryNumber": "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"
    }
  }
]