Skip to main content

​
Overview

The Government Identifiers API manages official identification numbers issued by government authorities, such as EINs, VAT numbers, tax IDs, and company registration numbers across 50+ countries.

​
Core endpoints

​
List government identifiers

Get all government identifiers for a business entity. 
GET /business-entity/:businessEntityId/government-identifiers
Path parameters
ParameterTypeDescription
businessEntityIdintegerUnique identifier for the business entity
Query parameters
ParameterTypeDescription
extendstring[]Optional fields to include: supportingDocument
Response 
{
  "governmentIdentifiers": [
    {
      "id": "gi_abc123",
      "type": "EIN",
      "value": "12-3456789",
      "country": "US",
      "jurisdiction": "FEDERAL",
      "issuedDate": "2020-01-15",
      "expiryDate": null,
      "status": "ACTIVE",
      "supportingDocument": {
        "fileId": "file_xyz789",
        "fileName": "EIN_Letter.pdf"
      }
    }
  ],
  "count": 1
}

​
Get government identifier

Retrieve a single government identifier by ID. 
GET /business-entity/:businessEntityId/government-identifiers/:governmentIdentifierId
Path parameters
ParameterTypeDescription
businessEntityIdintegerBusiness entity ID
governmentIdentifierIdstringGovernment identifier ID
Response 
{
  "id": "gi_abc123",
  "type": "EIN",
  "value": "12-3456789",
  "country": "US",
  "jurisdiction": "FEDERAL",
  "issuedDate": "2020-01-15",
  "expiryDate": null,
  "status": "ACTIVE",
  "purpose": "TAXATION",
  "supportingDocument": {
    "fileId": "file_xyz789",
    "fileName": "EIN_Letter.pdf"
  }
}

​
Create government identifier

Add a new government identifier to a business entity. 
POST /business-entity/:businessEntityId/government-identifiers
Path parameters
ParameterTypeDescription
businessEntityIdintegerBusiness entity ID
Request body 
{
  "type": "EIN",
  "value": "12-3456789",
  "country": "US",
  "jurisdiction": "FEDERAL",
  "issuedDate": "2020-01-15",
  "status": "ACTIVE",
  "supportingDocument": {
    "fileId": "file_xyz789",
    "description": "EIN confirmation letter from IRS"
  }
}
Response 
{
  "governmentIdentifier": {
    "id": "gi_abc123"
  }
}

​
Update government identifier

Update an existing government identifier. 
POST /business-entity/:businessEntityId/government-identifiers/:governmentIdentifier
Path parameters
ParameterTypeDescription
businessEntityIdintegerBusiness entity ID
governmentIdentifierstringGovernment identifier ID
Request body 
{
  "value": "12-3456789",
  "issuedDate": "2020-01-15",
  "expiryDate": "2025-01-15",
  "status": "ACTIVE",
  "supportingDocument": {
    "fileId": "file_xyz789",
    "description": "Updated EIN letter"
  }
}
Response Returns 200 OK on success.

​
Supported identifier types

​
United States

TypeDescriptionFormatJurisdiction
EINEmployer Identification NumberXX-XXXXXXXFederal
STATE_ENTITY_NUMBERState entity registration numberVaries by stateState-level

​
India

TypeDescriptionFormat
PANPermanent Account Number[A-Z]{5}[0-9]{4}[A-Z]
TANTax Deduction Account Number[A-Z]{4}[0-9]{5}[A-Z]
GSTINGoods and Services Tax ID[0-9]{2}[A-Z]{5}[0-9]{4}[A-Z][0-9][Z][0-9A-Z]
CINCorporate Identity Number[LU][0-9]{5}[A-Z]{2}[0-9]{4}[A-Z]{3}[0-9]{6}
LLPINLimited Liability Partnership ID[A-Z]{3}-[0-9]{4}

​
United Kingdom

TypeDescriptionFormat
COMPANY_REGISTRATION_NUMBERCompanies House number[A-Z0-9]{8}
UTRUnique Taxpayer Reference[0-9]{10}
VAT_NUMBERVAT registration numberGB[0-9]{9}
PAYE_NUMBERPay As You Earn reference[0-9]{3}/[A-Z0-9]+

​
Canada

TypeDescriptionFormat
BUSINESS_NUMBERCRA Business Number[0-9]{9}
CORPORATION_NUMBERFederal corporation number[0-9]{7}
COMPANY_KEYProvincial company keyVaries by province

​
Singapore

TypeDescriptionFormat
UENUnique Entity Number[0-9]{9}[A-Z] or [0-9]{10}[A-Z]
GST_NUMBERGST registration numberM[0-9]{8}[A-Z]
CPF_SUBMISSION_NUMBERCPF submission number[0-9]{8}[A-Z]

​
United Arab Emirates

TypeDescription
LICENSE_NUMBERTrade license number
TRNTax Registration Number

​
Australia

TypeDescriptionFormat
ACNAustralian Company Number[0-9]{9}
ABNAustralian Business Number[0-9]{11}
TFNTax File Number[0-9]{9}
GST_NUMBERGST registration number[0-9]{11}

​
Germany

TypeDescriptionFormat
HRB_NUMBERCommercial register numberHRB [0-9]+
STEUERNUMMERTax numberVaries by state
VAT_NUMBERVAT identification numberDE[0-9]{9}

​
France

TypeDescriptionFormat
SIRENBusiness identification number[0-9]{9}
CORPORATE_TAX_NUMBERCorporate tax number[0-9]{13}
TVA_NUMBERVAT numberFR[0-9A-Z]{2}[0-9]{9}

​
Validation rules

Government identifiers are validated using jurisdiction-specific regex patterns. Invalid formats will return a 400 Bad Request error.

​
Supporting documents

Each government identifier can have an associated supporting document (e.g., EIN letter, tax registration certificate). Upload the file first using the Files API, then reference the fileId when creating or updating the identifier.