> ## Documentation Index > Fetch the complete documentation index at: https://docs.topograph.co/llms.txt > Use this file to discover all available pages before exploring further. # Search for companies > This endpoint allows you to search for companies based on a country code and a query string. The search can be performed using either a company legal name, commercial name, historical name, or registration number. Capabilities vary by country. A Legal Entity Identifier (LEI) is accepted as the query in every country and returns the company it designates. **Standard Mode (stream=false or omitted):** Returns JSON array of results once all search sources have completed. **Streaming Mode (stream=true):** Returns Server-Sent Events (SSE) with progressive results as each search source completes. The endpoint emits named events: - `progress`: Partial results from completed sources - `complete`: Final results when all sources finish - `error`: If the search fails Streaming is beneficial for countries with multiple search sources (e.g., Germany queries both Unternehmensregister and Handelsregister), providing faster time-to-first-result. Response times vary by country: from sub-second to up to 10 seconds. ## OpenAPI ````yaml get /v2/search openapi: 3.0.0 info: title: Topograph description: The Topograph API version: '0.1' contact: {} servers: - url: https://api.topograph.co security: - x-api-key: [] tags: [] paths: /v2/search: get: tags: - Search summary: Search for companies description: >- This endpoint allows you to search for companies based on a country code and a query string. The search can be performed using either a company legal name, commercial name, historical name, or registration number. Capabilities vary by country. A Legal Entity Identifier (LEI) is accepted as the query in every country and returns the company it designates. **Standard Mode (stream=false or omitted):** Returns JSON array of results once all search sources have completed. **Streaming Mode (stream=true):** Returns Server-Sent Events (SSE) with progressive results as each search source completes. The endpoint emits named events: - `progress`: Partial results from completed sources - `complete`: Final results when all sources finish - `error`: If the search fails Streaming is beneficial for countries with multiple search sources (e.g., Germany queries both Unternehmensregister and Handelsregister), providing faster time-to-first-result. Response times vary by country: from sub-second to up to 10 seconds. operationId: SearchController_searchV2_v2 parameters: - name: country required: true in: query description: >- The country code in ISO 3166-1 alpha-2 format (e.g., "FR" for France, "DE" for Germany). schema: example: FR type: string enum: - AT - BE - BG - CH - CN - CZ - CY - DE - DK - EE - ES - FI - FR - GB - GG - GR - HK - HR - HU - IE - IS - IT - JE - LI - LU - LV - MC - MT - MU - NL - 'NO' - PL - PT - RO - RU - SE - SG - SI - SK - VG - AG - BA - BR - IM - KY - US-FL - US-CO - US-IL - US-MA - US-MD - US-MI - US-TX - US-DE - UA - US-NY - US-NJ - US-NM - US-OH - US-WA - US-TN - US-GA - US-MN - US-MO - US-NV - RS - US-PA - US-WY - US-CT - US-UT - US-IA - US-ID - US-AZ - US-VA - US-MS - US-CA - US-OR - US-KY - US-NE - US-NC - US-AR - US-WI - US-SC - US-AL - US-AK - US-DC - US-IN - US-ME - US-MT - US-OK - US-SD - US-LA - US-WV - US-ND - US-VT - US-KS - US-RI - US-HI - LT - MD - MH - US-NH - CA-FED - CA-ON - CA-QC - CA-BC - CA-AB - CA-MB - CA-SK - CA-NS - CA-NL - CA-PE - CA-YT - CA-NT - name: query required: true in: query description: >- The search query, which can be a company name, a registration number or an LEI. Note that search capabilities may vary by country, with some supporting only name or registration number searches. An LEI (Legal Entity Identifier, 20 characters) is recognised in every country: it returns the company the LEI designates, under its registration number, or nothing. The LEI decides where that company is registered, so the result can carry another `countryCode` than the `country` requested. schema: example: Topograph type: string - name: stream required: false in: query description: >- Enable streaming mode. When true, returns Server-Sent Events (SSE) with progressive results as each search source completes. Set Accept header to "text/event-stream" for proper streaming. When false or omitted, returns standard JSON array after all sources complete. schema: example: true type: boolean - name: activeOnly required: false in: query description: >- When true, only companies the register reports as active are returned: dissolved, struck-off, deregistered and otherwise inactive companies are excluded. A company whose status the search source does not report is kept rather than hidden. Whether a country's search can return inactive companies at all, and how completely this filter applies there, is published per country in the catalog under `search`. When false or omitted, results are not filtered on status. schema: example: true type: boolean - name: strictActiveOnly required: false in: query description: >- When true, returns only results explicitly reported as active and excludes unknown statuses. Implies activeOnly. Status freshness depends on the search source; this does not request a new company verification. schema: example: false type: boolean - name: transliterate required: false in: query description: >- When true, user-facing string fields in the response (company names, addresses, person names, activity descriptions) are romanized from their native script to Latin characters on the way out. Internal data, cache, and billing are unaffected — only the response payload is transformed. Routing: Cyrillic/Greek/Hangul/Hebrew/Arabic/Thai via unidecode, Chinese via pinyin-pro (toneless), Japanese via kuroshiro (Hepburn). schema: example: false type: boolean responses: '200': description: List of companies (JSON when stream=false, SSE when stream=true) content: application/json: schema: type: array items: $ref: '#/components/schemas/SearchResult' text/event-stream: schema: type: string description: |- Server-Sent Events stream with named events: - `progress`: Partial results as sources complete - `complete`: Final results when all sources finish - `error`: Error occurred example: >- event: progress data: {"results":[{"id":"123","legalName":"Company A","countryCode":"DE","address":{...}}]} event: complete data: {"results":[{"id":"123","legalName":"Company A",...},{"id":"456","legalName":"Company B",...}]} '400': description: Bad Request - Invalid search query content: application/json: schema: type: object properties: statusCode: type: number example: 400 error: type: object properties: code: allOf: - $ref: '#/components/schemas/PublicErrorCode' example: invalid_request message: type: string example: >- Query is too short. Please provide at least 2 characters for company name search details: type: array items: type: string example: - Query must be at least 2 characters '500': description: Internal Server Error - Search failed content: application/json: schema: type: object properties: statusCode: type: number example: 500 error: type: object properties: code: allOf: - $ref: '#/components/schemas/PublicErrorCode' example: service_unavailable message: type: string example: >- An error occurred while searching. Please try again later. security: - x-api-key: [] components: schemas: SearchResult: type: object properties: address: description: The legal address of the company allOf: - $ref: '#/components/schemas/AddressDTO' id: type: string example: '932884117' description: >- The company number. In some countries, this might be a concatenation of the registry and city (e.g., in Germany: "Augsburg HRB 34617"). The search function will always return a usable company number. Check the documentation to see which number format is used for each country. legalName: type: string description: Legal name of the company example: SEMAPHORE legalNameInEnglish: type: string example: Test Display Hong Kong Trading Limited description: >- The English translation or romanization of the legal name, commonly used for international business. Particularly relevant for companies registered with non-Latin alphabet names (e.g., Chinese, Japanese, Korean, etc.). companyNameTransliterations: example: - Naftogaz - Naftohaz description: >- Deterministic Latin transliterations of the company name, computed using per-country standards (e.g. UA: GOST + KMU 55 + ISO 9). Useful for displaying alternative Latin spellings alongside the original-script `legalName`. Absent or empty for Latin-script companies and for non-Latin countries not yet covered. type: array items: type: string countryCode: type: string enum: - AF - AX - AL - DZ - AS - AD - AO - AI - AQ - AG - AR - AM - AW - AU - AT - AZ - BS - BH - BD - BB - BY - BE - BZ - BJ - BM - BT - BO - BQ - BA - BW - BV - BR - IO - BN - BG - BF - BI - KH - CM - CA - CA-FED - CA-ON - CA-QC - CA-BC - CA-AB - CA-MB - CA-SK - CA-NS - CA-NB - CA-NL - CA-PE - CA-YT - CA-NT - CA-NU - CV - KY - CF - TD - CL - CN - CX - CC - CO - KM - CG - CD - CK - CR - CI - HR - CU - CW - CY - CZ - DK - DJ - DM - DO - EC - EG - SV - GQ - ER - EE - ET - FK - FO - FJ - FI - FR - GF - PF - TF - GA - GM - GE - DE - DE-SCHUFA - GH - GI - GR - GL - GD - GP - GU - GT - GG - GN - GW - GY - HT - HM - VA - HN - HK - HU - IS - IN - ID - IR - IQ - IE - IM - IL - IT - JM - JP - JE - JO - KZ - KE - KI - KR - KP - KW - KG - LA - LV - LB - LS - LR - LY - LI - LT - LU - MO - MK - MG - MW - MY - MV - ML - MT - MH - MQ - MR - MU - YT - MX - FM - MD - MC - MN - ME - MS - MA - MZ - MM - NA - NR - NP - NL - NC - NZ - NI - NE - NG - NU - NF - MP - 'NO' - OM - PK - PW - PS - PA - PG - PY - PE - PH - PN - PL - PT - PR - QA - RE - RO - RU - RW - BL - SH - KN - LC - MF - PM - VC - WS - SM - ST - SA - SN - RS - SC - SL - SG - SX - SK - SI - SB - SO - ZA - GS - SS - ES - LK - SD - SR - SJ - SZ - SE - CH - SY - TW - TJ - TZ - TH - TL - TG - TK - TO - TT - TN - TR - TM - TC - TV - UG - UA - AE - GB - US - UM - UY - UZ - VU - VE - VN - VG - VI - WF - EH - YE - ZM - ZW - US-FL - US-CO - US-IL - US-MA - US-MD - US-MI - US-NJ - US-NM - US-NY - US-OH - US-TX - US-DE - US-WA - US-AL - US-TN - US-WY - US-GA - US-MN - US-MO - US-NV - US-PA - US-CT - US-UT - US-IA - US-ID - US-AZ - US-VA - US-MS - US-CA - US-OR - US-KY - US-NE - US-NC - US-AR - US-WI - US-SC - US-AK - US-DC - US-IN - US-ME - US-MT - US-OK - US-SD - US-LA - US-WV - US-ND - US-VT - US-KS - US-RI - US-HI - US-NH - TEST example: FR description: >- The country code in ISO 3166-1 alpha-2 format (e.g., "FR" for France, "DE" for Germany). matchReason: description: >- Match reason containing information about why this result was returned. Includes the match type and which identifier matched for ID matches. example: matchType: default allOf: - $ref: '#/components/schemas/MatchReason' required: - address - id - legalName - countryCode - matchReason PublicErrorCode: type: string enum: - resource_not_found - service_unavailable - source_unavailable - processing_failed - invalid_request - insufficient_funds - datapoint_not_supported - fast_source_unavailable - authoritative_source_unavailable - onboarding_timeout - no_data_available - no_document_available - manual_document_timeout - datapoint_not_applicable - account_configuration_required - budget_exceeded - request_cancelled - processing_interrupted - balance_negative description: >- Every error code the API can return, in `dataStatus.*.error.code` and in the `error.code` of an HTTP error body. Each code has a fixed `retryable` flag and, when retryable, a recommended minimum `retryAfterSeconds` before resubmitting the same request. - `service_unavailable` (retryable, retry after 300s, action `retry_later`): Topograph could not complete the lookup because of a temporary problem on its side. - `source_unavailable` (retryable, retry after 300s, action `retry_later`): The register behind this datapoint is down, rate limiting or timing out; `error.source` names it when known. - `processing_failed` (retryable, retry after 900s, action `retry_later`): The register answered, but Topograph could not process the response; the team is alerted automatically. - `request_cancelled` (retryable, retry after 0s, action `retry_now`): The request was cancelled before this item completed. - `processing_interrupted` (retryable, retry after 0s, action `retry_now`): Processing was interrupted before this item completed; no verdict was reached. - `resource_not_found` (not retryable, action `none`): No company exists in the register under this identifier. - `invalid_request` (not retryable, action `fix_request`): The request is malformed: an unknown datapoint, a badly formatted identifier or an invalid parameter. - `insufficient_funds` (not retryable, action `add_funds`): The wallet balance does not cover the price of this request. - `datapoint_not_supported` (not retryable, action `none`): Topograph does not return this datapoint for this country, in any mode. - `fast_source_unavailable` (not retryable, action `retry_without_onboarding_mode`): The datapoint exists for this country, but not in prefill mode. - `authoritative_source_unavailable` (not retryable, action `retry_with_onboarding_mode`): The datapoint exists for this country, but only from a non-authoritative source, which verification mode does not use. - `onboarding_timeout` (not retryable, action `retry_without_onboarding_mode`): The datapoint did not finish within the prefill-mode deadline. - `no_data_available` (not retryable, action `none`): The register answered, but holds no data for this company and datapoint. - `no_document_available` (not retryable, action `none`): The requested document is not available for this company; failed document orders are not charged. - `manual_document_timeout` (not retryable, action `contact_support`): A manually fulfilled document was not delivered within the expected timeframe. - `datapoint_not_applicable` (not retryable, action `none`): The datapoint does not exist for this entity's legal form, for example the shareholders of a sole trader. - `account_configuration_required` (not retryable, action `configure_account`): The data source needs account-specific credentials that are not configured on your account. - `budget_exceeded` (not retryable, action `raise_budget`): The quoted price exceeds the budget cap set on the request. - `balance_negative` (not retryable, action `add_funds`): The wallet balance is below zero; every request is refused until it is topped up. AddressDTO: type: object properties: addressLine1: type: string description: First line of the address example: 10 rue de la Fraternité addressLine2: type: string description: Second line of the address example: Topograph Building city: type: string description: City of the address example: Bagnolet postalCode: type: string description: Postal code of the address example: '93170' region: type: string description: Region of the address example: FR countryCode: type: string description: Country of the address using ISO 3166-1 alpha-2 country code example: FR poBox: type: string description: Post Office Box number example: PO Box 123 careOf: type: string description: Care of (c/o) recipient example: c/o John Doe state: type: string description: State of the address example: Île-de-France latitude: type: number description: Latitude coordinate example: 59.9139 longitude: type: number description: Longitude coordinate example: 10.7522 MatchReason: type: object properties: matchType: description: >- The type of match that produced this result. "id" means a guaranteed 1:1 match from an ID-based search (e.g., VAT number, CCIAA+REA). "exactLegalName" means the legal name exactly matches the search query. "partialId" means matched by a partial identifier that is not guaranteed unique (e.g., REA without CCIAA). "default" is used when the exact matching criteria is unknown. Results are ordered: id > exactLegalName > partialId > default. example: id allOf: - $ref: '#/components/schemas/MatchType' identifier: description: >- The identifier that matched this result. Present when matchType is "id" or "partialId". Shows which identifier type and value were used to find this company. anyOf: - $ref: '#/components/schemas/AntiguaBarbudaIdentifiers' title: AG - $ref: '#/components/schemas/ItalyIdentifiers' title: IT - $ref: '#/components/schemas/FranceIdentifiers' title: FR - $ref: '#/components/schemas/AustriaIdentifiers' title: AT - $ref: '#/components/schemas/BelgiumIdentifiers' title: BE - $ref: '#/components/schemas/BrazilIdentifiers' title: BR - $ref: '#/components/schemas/SwitzerlandIdentifiers' title: CH - $ref: '#/components/schemas/ChinaIdentifiers' title: CN - $ref: '#/components/schemas/CyprusIdentifiers' title: CY - $ref: '#/components/schemas/CzechiaIdentifiers' title: CZ - $ref: '#/components/schemas/GermanyIdentifiers' title: DE - $ref: '#/components/schemas/DenmarkIdentifiers' title: DK - $ref: '#/components/schemas/EstoniaIdentifiers' title: EE - $ref: '#/components/schemas/FinlandIdentifiers' title: FI - $ref: '#/components/schemas/GuernseyIdentifiers' title: GG - $ref: '#/components/schemas/HongKongIdentifiers' title: HK - $ref: '#/components/schemas/CroatiaIdentifiers' title: HR - $ref: '#/components/schemas/HungaryIdentifiers' title: HU - $ref: '#/components/schemas/IcelandIdentifiers' title: IS - $ref: '#/components/schemas/IrelandIdentifiers' title: IE - $ref: '#/components/schemas/IsleOfManIdentifiers' title: IM - $ref: '#/components/schemas/JerseyIdentifiers' title: JE - $ref: '#/components/schemas/LiechtensteinIdentifiers' title: LI - $ref: '#/components/schemas/LuxembourgIdentifiers' title: LU - $ref: '#/components/schemas/LatviaIdentifiers' title: LV - $ref: '#/components/schemas/MonacoIdentifiers' title: MC - $ref: '#/components/schemas/MaltaIdentifiers' title: MT - $ref: '#/components/schemas/MauritiusIdentifiers' title: MU - $ref: '#/components/schemas/NetherlandsIdentifiers' title: NL - $ref: '#/components/schemas/NorwayIdentifiers' title: 'NO' - $ref: '#/components/schemas/PolandIdentifiers' title: PL - $ref: '#/components/schemas/PortugalIdentifiers' title: PT - $ref: '#/components/schemas/RomaniaIdentifiers' title: RO - $ref: '#/components/schemas/SerbiaIdentifiers' title: RS - $ref: '#/components/schemas/SwedenIdentifiers' title: SE - $ref: '#/components/schemas/SlovakiaIdentifiers' title: SK - $ref: '#/components/schemas/SloveniaIdentifiers' title: SI - $ref: '#/components/schemas/SpainIdentifiersDTO' title: ES - $ref: '#/components/schemas/UnitedKingdomIdentifiers' title: GB - $ref: '#/components/schemas/BVIIdentifiers' title: VG - $ref: '#/components/schemas/BosniaIdentifiers' title: BA - $ref: '#/components/schemas/BulgariaIdentifiers' title: BG - $ref: '#/components/schemas/GreeceIdentifiers' title: GR - $ref: '#/components/schemas/LithuaniaIdentifiers' title: LT - $ref: '#/components/schemas/MoldovaIdentifiers' title: MD - $ref: '#/components/schemas/RussiaIdentifiers' title: RU - $ref: '#/components/schemas/SingaporeIdentifiers' title: SG - $ref: '#/components/schemas/UkraineIdentifiers' title: UA - $ref: '#/components/schemas/CaymanIdentifiers' title: KY - $ref: '#/components/schemas/MarshallIslandsIdentifiers' title: MH - $ref: '#/components/schemas/CanadaFederalIdentifiers' title: CA-FED - title: US-AK type: object properties: entityNumber: type: string description: >- Alaska Entity Number: 1 to 8 digits for entities in the current numbering (e.g. 10310827, 131088). Some records carry a letter suffix after the digits; observed suffixes include D, F, H, PD and PF (e.g. 72D, 476F, 4109H, 54PD). Preserve the suffix; the list is not exhaustive. Primary identifier assigned by the Alaska Division of Corporations, Business and Professional Licensing (CBPL). example: '10310827' licenseNumber: type: string description: >- Alaska Business License Number: 1 to 7 digits (e.g. 2200860). This is the value returned in company.identifiers.licenseNumber. The company id of a license holder is the license number prefixed with AKBL- (e.g. AKBL-2200860). Primary identifier for sole proprietors and other business-license holders not present in the corporations register. Search results and company.id carry the AKBL- form, which keeps license numbers apart from entity numbers: use it as the id on /v2/company. The bare license number is accepted too, but a bare number is first read as an entity number. Corporation extracts and filings are not available for AKBL- license records. example: '2200860' lei: type: string description: >- Legal Entity Identifier (LEI): 20 uppercase alphanumeric characters, ending with 2 digits Returned when a company identifier uniquely matches a GLEIF registration or validation reference. Coverage varies by jurisdiction and entity. Lapsed and retired LEIs may be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 - title: US-AL type: object properties: entityId: type: string description: >- Entity ID Number: 9 digits, no separators, leading zeros significant (e.g. 000358845, 001226798). The Secretary of State moved from 6-digit to 9-digit Entity IDs by adding three leading zeros to existing numbers, so older entities start with 000. The register displays the number with dashes (000-358-845). Input with dashes or without the leading zeros (358845) is also accepted. Primary identifier assigned by the Alabama Secretary of State Business Entities Division (ARC-SOS). Responses always return the 9-digit form without dashes. example: '000358845' lei: type: string description: >- Legal Entity Identifier (LEI): 20 uppercase alphanumeric characters, ending with 2 digits Returned when a company identifier uniquely matches a GLEIF registration or validation reference. Coverage varies by jurisdiction and entity. Lapsed and retired LEIs may be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 - title: US-AR type: object properties: filingNumber: type: string description: >- Arkansas Filing Number: 8 or 9 digits. Observed filing numbers include 100, 200 and 811 prefixes (e.g. 200000034); the supported numeric format also admits 800 prefixes. Do not restrict validation to a list of prefixes. Primary identifier assigned by the Arkansas Secretary of State Business & Commercial Services register. example: '811388512' lei: type: string description: >- Legal Entity Identifier (LEI): 20 uppercase alphanumeric characters, ending with 2 digits Returned when a company identifier uniquely matches a GLEIF registration or validation reference. Coverage varies by jurisdiction and entity. Lapsed and retired LEIs may be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 - title: US-AZ type: object properties: entityNumber: type: string description: >- Arizona Entity Number: Either 7 or 8 digits with no prefix, leading zeros significant (e.g. 01138954, 1864605, 23906030), or one letter followed by 7 or 8 digits (e.g. L10176615, F00005784, R18260883, N16431384, M0900455). Observed prefixes include F, L, M, N, P and R (e.g. P15768203); this is not an exhaustive prefix list. Primary identifier assigned by the Arizona Corporation Commission. The letter, when present, is part of the number: pass the identifier exactly as a search result returns it, without restricting letters to a fixed list. Secretary of State trade-name and trademark registrations are a separate namespace; their numbers are not interchangeable with ACC entity numbers and are not offered as a separate lookup. example: R18260883 lei: type: string description: >- Legal Entity Identifier (LEI): 20 uppercase alphanumeric characters, ending with 2 digits Returned when a company identifier uniquely matches a GLEIF registration or validation reference. Coverage varies by jurisdiction and entity. Lapsed and retired LEIs may be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 - title: US-CA type: object properties: entityNumber: type: string description: >- California Entity Number: Digits only, or B followed by 11 digits, returned without the C the register writes in front of corporation numbers and without leading zeros. Corporations: up to 7 digits (e.g. 806592, 3731484, which the register writes C0806592 and C3731484). LLCs and limited partnerships registered before 2025: 12 digits (e.g. 201806210004). Corporations, LLCs and limited partnerships registered since 2025: B followed by 11 digits (e.g. B20260142586); the B is part of the number. Primary identifier assigned by the California Secretary of State, visible on the bizfileOnline portal. Corporation numbers are accepted with or without the C prefix and leading zeros. Keep the B on numbers that have one. example: '806592' lei: type: string description: >- Legal Entity Identifier (LEI): 20 uppercase alphanumeric characters, ending with 2 digits Returned when a company identifier uniquely matches a GLEIF registration or validation reference. Coverage varies by jurisdiction and entity. Lapsed and retired LEIs may be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 - title: US-CO type: object properties: entityId: type: string description: >- Colorado SOS Entity ID: Digits only, no separators. Usually 11 digits (e.g. 19931121425, 20248299164); the historical entity 1923178226 has 10 digits on both the live register and its open data. Both lengths are accepted unchanged. Primary identifier assigned by the Colorado Secretary of State business database, shown as the ID number on the entity summary page. example: '19931121425' lei: type: string description: >- Legal Entity Identifier (LEI): 20 uppercase alphanumeric characters, ending with 2 digits Returned when a company identifier uniquely matches a GLEIF registration or validation reference. Coverage varies by jurisdiction and entity. Lapsed and retired LEIs may be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 - title: US-CT type: object properties: accountNumber: type: string description: >- Account Number: 7 digits, no separators, leading zeros significant (e.g. 0668349, 3453337). Primary identifier assigned by the Connecticut Secretary of the State, and the value returned as `company.id`. The composite ALEI form and a number without its leading zeros (668349) are also accepted on input. example: '0668349' alei: type: string description: >- ALEI (Administrative Legal Entity Identifier): Composite string US-CT.BER: followed by the 7-digit account number, leading zeros kept (e.g. US-CT.BER:0668349) The account number carrying its register prefix. This is the form shown on the public Business Records Search portal. Returned alongside the bare account number in every profile response, and accepted interchangeably on input. example: US-CT.BER:0668349 lei: type: string description: >- Legal Entity Identifier (LEI): 20 uppercase alphanumeric characters, ending with 2 digits Returned when a company identifier uniquely matches a GLEIF registration or validation reference. Coverage varies by jurisdiction and entity. Lapsed and retired LEIs may be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 - title: US-DC type: object properties: fileNumber: type: string description: >- DC File Number: The file number exactly as the register issued it, uppercase, in one of these shapes: 1 to 6 digits, leading zeros significant (e.g. 571294, 004285); one letter followed by 4 to 6 digits (e.g. L14177, C013788); one letter followed by 10 or 11 digits (e.g. L00005531281, L0000053226); two letters followed by 10 digits (e.g. AC0004848765); and, for recently registered entities, US-DC- followed by two letters and 9 digits (e.g. US-DC-LL082600020, US-DC-FN042602087). In the US-DC- form the two letters match the entity type in the records we have seen: LL domestic LLC, CO domestic corporation, NP domestic nonprofit, LP domestic limited partnership, ST domestic statutory trust, GC and LC cooperative associations, FN any foreign entity. In the older lettered forms the letter does not reliably give the entity type (many foreign LLCs carry a C number). A handful of old records carry irregular values such as 951448-4164482. Primary identifier assigned by the DC Department of Licensing and Consumer Protection. Pass it exactly as a search result returns it, including leading zeros and the US-DC- prefix where present. example: L00005531281 lei: type: string description: >- Legal Entity Identifier (LEI): 20 uppercase alphanumeric characters, ending with 2 digits Returned when a company identifier uniquely matches a GLEIF registration or validation reference. Coverage varies by jurisdiction and entity. Lapsed and retired LEIs may be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 - title: US-DE type: object properties: fileNumber: type: string description: >- Delaware File Number: Digits only, no separators and no leading zeros. In the records we have seen: 4 to 8 digits, most often 7 (e.g. 3177627) or 8 (e.g. 10171608), and shorter numbers such as 523608, 23110 or 4305. The Division of Corporations does not publish a fixed length. Primary identifier assigned by the Delaware Division of Corporations at formation. Covers all entity types registered with ICIS eCorp. example: '3177627' lei: type: string description: >- Legal Entity Identifier (LEI): 20 uppercase alphanumeric characters, ending with 2 digits Returned when a company identifier uniquely matches a GLEIF registration or validation reference. Coverage varies by jurisdiction and entity. Lapsed and retired LEIs may be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 - title: US-FL type: object properties: documentNumber: type: string description: >- Document Number: Either 12 or 6 characters. 12 characters: one uppercase letter followed by 11 digits (e.g. P99000001570, L22000252360). 6 characters, on older filings: six digits (e.g. 112252) or one letter followed by five digits (e.g. A17753, G10360). The letter reflects the filing type and period, e.g. P (domestic profit corporation), L (LLC), F (foreign entity); letters in use include A, F, G, H, K, L, M, N, P, S, T and W. Primary identifier assigned by the Florida Division of Corporations. Visible on every Sunbiz entity detail page and used to look up filings on search.sunbiz.org. example: P99000001570 feiNumber: type: string description: >- FEI / EIN: 9 digits issued by the U.S. Internal Revenue Service. Accepted with or without the standard hyphen (e.g. 59-0324412 or 590324412). Not all entities carry an FEI/EIN on file, so a lookup by this identifier may return no result even for an active entity. Returned in `company.identifiers.feiNumber` as the register stores it, typically with the hyphen. example: 59-0324412 lei: type: string description: >- Legal Entity Identifier (LEI): 20 uppercase alphanumeric characters, ending with 2 digits Returned when a company identifier uniquely matches a GLEIF registration or validation reference. Coverage varies by jurisdiction and entity. Lapsed and retired LEIs may be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 - title: US-GA type: object properties: controlNumber: type: string description: >- Control Number: Up to 8 characters. Recent entities: 8 digits (e.g. 11078964). Older entities: 7 digits with leading zeros (e.g. 0003726), or one letter followed by 6 digits (e.g. H852680, J716207, K404041, A401954). A few legacy records carry "0" + a letter + 5 digits (e.g. 0F00549). The letter belongs to an older numbering series and says nothing about whether the entity is domestic or foreign. Primary identifier assigned by the Georgia Secretary of State Corporations Division (eCorp). example: H852680 lei: type: string description: >- Legal Entity Identifier (LEI): 20 uppercase alphanumeric characters, ending with 2 digits Returned when a company identifier uniquely matches a GLEIF registration or validation reference. Coverage varies by jurisdiction and entity. Lapsed and retired LEIs may be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 - title: US-HI type: object properties: fileNumber: type: string description: >- Hawaii BREG File Number: A number of up to 7 digits with no leading zeros (3 to 6 digits in the records we have seen), followed directly by a two-character suffix of one uppercase letter and one digit, with no space (e.g. 112127D1, 270541C5, 33838F1, 151D1). The suffix is the register's entity-type code, e.g. D1 Domestic Profit Corporation, C5 Domestic Limited Liability Company. The register displays the number with a space before the suffix (112127 D1); both forms are accepted on input. Primary identifier assigned by the Hawaii Business Registration Division (DCCA / BREG). The suffix is part of the identifier: a number sent without it is not recognised. Responses return the form without a space. example: 112127D1 lei: type: string description: >- Legal Entity Identifier (LEI): 20 uppercase alphanumeric characters, ending with 2 digits Returned when a company identifier uniquely matches a GLEIF registration or validation reference. Coverage varies by jurisdiction and entity. Lapsed and retired LEIs may be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 - title: US-IA type: object properties: corpNumber: type: string description: >- Iowa Business Entity Number: 6 digits, numeric only, with leading zeros preserved (e.g. 084726). Primary identifier assigned by the Iowa Secretary of State, Business Services Division. example: '084726' lei: type: string description: >- Legal Entity Identifier (LEI): 20 uppercase alphanumeric characters, ending with 2 digits Returned when a company identifier uniquely matches a GLEIF registration or validation reference. Coverage varies by jurisdiction and entity. Lapsed and retired LEIs may be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 - title: US-ID type: object properties: entityNumber: type: string description: >- Idaho SoS Entity Number: Digits only, up to 10, returned without leading zeros and with no prefix or separators. The records we have seen carry 3 to 7 digits (e.g. 481, 9532, 586619, 3960192). The register also shows the number zero-padded to 10 digits (e.g. 0003960192); that form is accepted too. Primary identifier assigned by the Idaho Secretary of State and shown on its SOSBiz register. Search results and company.id carry it without leading zeros. A number typed into name search is matched as free text, not as an identifier: request the company with it directly. example: '3960192' lei: type: string description: >- Legal Entity Identifier (LEI): 20 uppercase alphanumeric characters, ending with 2 digits Returned when a company identifier uniquely matches a GLEIF registration or validation reference. Coverage varies by jurisdiction and entity. Lapsed and retired LEIs may be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 - title: US-IL type: object properties: fileNumber: type: string description: >- ILSOS File Number: 8 digits, leading zeros included, no separators (e.g. 08142220, 00263028). This is the value returned in company.identifiers.fileNumber. Illinois numbers corporations and LLCs in separate sequences, so one number can belong to two entities. Search results and company.id therefore carry a one-letter prefix that is ours, not the register's: C for an entity on the corporation register (including not-for-profit corporations) and L for an LLC (e.g. C08142220, L02664844). Primary identifier assigned by the Illinois Secretary of State, Department of Business Services. Use the prefixed id from search results on /v2/company. A bare 8-digit number is accepted too, but when it matches both a corporation and an LLC the request is refused and the prefixed form is required. example: '08142220' lei: type: string description: >- Legal Entity Identifier (LEI): 20 uppercase alphanumeric characters, ending with 2 digits Returned when a company identifier uniquely matches a GLEIF registration or validation reference. Coverage varies by jurisdiction and entity. Lapsed and retired LEIs may be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 - title: US-IN type: object properties: entityNumber: type: string description: >- Indiana Business Entity Number: Several formats, by period: 13 to 16 digits (e.g. 2001111900027, 202406111799031); 8 to 12 digits (e.g. 1997051343); a legacy form of 6 digits, then a hyphen or a letter, then 3 digits (e.g. 183025-143, 193046A080); and LP followed by 8 digits for older limited partnerships (e.g. LP93120064). All formats are accepted for search. Primary identifier assigned by the Indiana Secretary of State Business Services Division (BSD). The format reflects the era of formation. example: 183025-143 lei: type: string description: >- Legal Entity Identifier (LEI): 20 uppercase alphanumeric characters, ending with 2 digits Returned when a company identifier uniquely matches a GLEIF registration or validation reference. Coverage varies by jurisdiction and entity. Lapsed and retired LEIs may be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 - title: US-KS type: object properties: businessId: type: string description: >- Kansas SoS Business ID: Numeric, no dashes or spaces. 6 to 8 digits in the records we have seen; none of those sampled IDs had a leading zero (e.g. 602771, 6749200, 10049404). Distinct from the Federal Employer Identification Number (FEIN). Primary identifier assigned by the Kansas Secretary of State Business Services Division. The observed lengths are not an exhaustive register specification. Preserve the returned ID as a string, including any leading zeros; do not pad it to a fixed width. example: '6749200' lei: type: string description: >- Legal Entity Identifier (LEI): 20 uppercase alphanumeric characters, ending with 2 digits Returned when a company identifier uniquely matches a GLEIF registration or validation reference. Coverage varies by jurisdiction and entity. Lapsed and retired LEIs may be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 - title: US-KY type: object properties: organizationNumber: type: string description: >- Kentucky Organization Number: 7 digits, leading zeros included, no prefix or separators (e.g. 0061792, 1255687). A number sent without its leading zeros (e.g. 61792) is padded to 7 digits. Primary identifier assigned by the Kentucky Secretary of State, Business Filings division. An entity and its assumed names share one Organization Number, which resolves to the entity itself. example: '0061792' lei: type: string description: >- Legal Entity Identifier (LEI): 20 uppercase alphanumeric characters, ending with 2 digits Returned when a company identifier uniquely matches a GLEIF registration or validation reference. Coverage varies by jurisdiction and entity. Lapsed and retired LEIs may be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 - title: US-LA type: object properties: charterNumber: type: string description: >- Louisiana Charter Number: 9 characters: 8 digits followed by one uppercase letter, no separators. Leading zeros are part of the number (e.g. 29504510F, 36528934K, 03002150N). Letters in the records we have seen: D, F, K, L, N and X. Primary identifier assigned by the Louisiana Secretary of State, Commercial Division, which documents it as 8 digits plus one letter. Send all 9 characters. example: 29504510F lei: type: string description: >- Legal Entity Identifier (LEI): 20 uppercase alphanumeric characters, ending with 2 digits Returned when a company identifier uniquely matches a GLEIF registration or validation reference. Coverage varies by jurisdiction and entity. Lapsed and retired LEIs may be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 - title: US-MA type: object properties: maSocId: type: string description: >- MA Secretary of the Commonwealth Entity ID: 9 digits, leading zeros included, no separators (e.g. 000804945, 041543470). Some trusts carry the letter T followed by 8 digits instead (observed). Primary identifier assigned by the Massachusetts Secretary of the Commonwealth, Corporations Division, shown on the register as the Identification Number. Send it with its leading zeros. example: '000804945' dlsId: type: string description: >- DLS Synthetic Identifier: 12 lowercase hexadecimal characters (e.g. 19dcdd187b79). Not a register number: it is derived from the entity name and city listed in the annual Corporations Book of the Division of Local Services, so it changes when either changes in a later edition. Returned as the id of name-search results, and accepted as a search query and on /v2/company. Company profiles carry the official maSocId instead: keep that one. example: 19dcdd187b79 lei: type: string description: >- Legal Entity Identifier (LEI): 20 uppercase alphanumeric characters, ending with 2 digits Returned when a company identifier uniquely matches a GLEIF registration or validation reference. Coverage varies by jurisdiction and entity. Lapsed and retired LEIs may be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 - title: US-MD type: object properties: departmentId: type: string description: >- SDAT Department ID: One uppercase letter followed by 8 digits, no separators (e.g. D22958060, W05989793, T00371146). SDAT documents that the letter corresponds to the entity type: D (Maryland corporation, stock or non-stock), F (foreign corporation), W (Maryland LLC), Z (foreign LLC), M and P (Maryland and foreign limited partnership), A and E (Maryland and foreign LLP), B and S (Maryland and foreign statutory trust), L (sole proprietorship or general partnership), T (trade name). Primary identifier assigned by the Maryland State Department of Assessments and Taxation (SDAT), served via the Maryland Business Express portal. An entity that converts to another entity type receives a new Department ID. Trade names (T) appear in name search results but the register publishes no company record for them, so they cannot be retrieved on /v2/company. example: D22958060 businessCode: type: string description: >- SDAT Business Code: Two-digit code followed by a descriptive label (e.g. "04 ORDINARY BUSINESS - NON-STOCK") Secondary SDAT classification code published on the entity detail page. Not present for all entities. example: 04 ORDINARY BUSINESS - NON-STOCK stateOfFormation: type: string description: >- State of formation: Free text, as published by SDAT State where the entity was originally formed. Returned only when the register publishes it. example: MARYLAND lei: type: string description: >- Legal Entity Identifier (LEI): 20 uppercase alphanumeric characters, ending with 2 digits Returned when a company identifier uniquely matches a GLEIF registration or validation reference. Coverage varies by jurisdiction and entity. Lapsed and retired LEIs may be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 - title: US-ME type: object properties: charterNumber: type: string description: >- Maine Charter Number: 8 or 9 digits followed by a one- or two-letter entity-type suffix. A two-letter suffix follows the digits directly (e.g. 19970058LP, 202509124DC); a one-letter suffix is preceded by a space (e.g. 19340021 D, 202500963 F). The Secretary of State documents these suffixes: D, B, RR, CP and I (Maine business corporation), F (foreign business corporation), ND and NF (Maine and foreign nonprofit corporation), DC and FC (Maine and foreign LLC), LP and LF (Maine and foreign limited partnership), DP and FP (Maine and foreign LLP). Other suffixes appear in the records we have seen (e.g. GP). Unique, constant identifier assigned by the Maine Secretary of State to each entity. Accepted with or without the space before a one-letter suffix; responses keep the space. example: 19970058LP lei: type: string description: >- Legal Entity Identifier (LEI): 20 uppercase alphanumeric characters, ending with 2 digits Returned when a company identifier uniquely matches a GLEIF registration or validation reference. Coverage varies by jurisdiction and entity. Lapsed and retired LEIs may be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 - title: US-MI type: object properties: miIdNumber: type: string description: >- Michigan LARA Identification Number: 9 digits, no prefix or separators (e.g. 800853791, 801056837, 900145929). Primary identifier assigned by the Michigan Department of Licensing and Regulatory Affairs (LARA) Corporations Division. Printed on every filing and shown on the MiBusiness Registry entity detail page. Michigan assigned these 9-digit numbers in 2017, replacing the older six-character IDs: send the 9-digit number. example: '800853791' lei: type: string description: >- Legal Entity Identifier (LEI): 20 uppercase alphanumeric characters, ending with 2 digits Returned when a company identifier uniquely matches a GLEIF registration or validation reference. Coverage varies by jurisdiction and entity. Lapsed and retired LEIs may be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 - title: US-MN type: object properties: fileNumber: type: string description: >- Minnesota File Number: Variable length, digits and uppercase letters, with at most one internal dash. The register documents that a file number may contain dashes and letters; both are part of the number. Recent filings carry a long all-digit number, 12 digits in the records we have seen (e.g. 631180100027). Older filings carry shorter numbers: all digits (e.g. 5451, 68758) or letters and digits around a dash (e.g. 11-AA, 1K-1056, 886-NPA, 4V-200). Accepted in any letter case. Primary identifier assigned by the Minnesota Secretary of State (Minnesota Business & Lien System, MBLS). Name search results do not carry it: their id is the MBLS Filing GUID (see filingGuid). A file number is not unique on its own: the register treats file number and business type together as the unique key, and the same number can belong to entities of different types (e.g. 4912 is both an assumed name and a trademark). When a file number matches more than one entity, look the company up by its Filing GUID. example: '631180100027' filingGuid: type: string description: >- MBLS Filing GUID: 36 characters: 32 lowercase hexadecimal digits in groups of 8, 4, 4, 4 and 12, separated by hyphens (e.g. e4d83ed9-ae4b-e211-bc43-001ec94ffe7f). It has the layout of a UUID but does not follow the UUID version rules (the first digit of the third group is e or f in the records we have seen), so validate the pattern, not a UUID version. Accepted in any letter case. Identifier of the entity record on the MBLS portal. It is the id of every name search result and always resolves to a single entity: pass it as the id on /v2/company. Returned in company.identifiers when available and accepted as a search input. example: e4d83ed9-ae4b-e211-bc43-001ec94ffe7f lei: type: string description: >- Legal Entity Identifier (LEI): 20 uppercase alphanumeric characters, ending with 2 digits Returned when a company identifier uniquely matches a GLEIF registration or validation reference. Coverage varies by jurisdiction and entity. Lapsed and retired LEIs may be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 - title: US-MO type: object properties: entityId: type: string description: >- Missouri Business Identification Number (BIN): Two register forms. Observed prefixed charter numbers have one or two letters followed by 7 to 9 digits (e.g. F00214431, LC1026096, LC014399166, N00024686). The letters are the register filing category: F (for-profit corporation), LC (domestic LLC), FL (foreign LLC), N (non-profit corporation), LP (limited partnership), H (credit union), K (bank), B (benevolent corporation), O (insurance company), X (fictitious name); the list is not closed. Some for-profit corporations carry 8 digits with no prefix, leading zeros included (e.g. 00333672). Search-result ids may also be MOBSD- followed by the numeric portal record number (e.g. MOBSD-551157); this Topograph id is not a BIN. Primary identifier assigned by the Missouri Secretary of State (BSD). Name search returns the charter number for its first results; the others come back under a Topograph id, MOBSD- followed by the register record number (e.g. MOBSD-551157). Send that id to /v2/company as is: the response carries the charter number as company.id. Leading zeros in a BIN are significant. Bare 8-digit numbers are read as BINs, never as portal record numbers; a record number requires MOBSD-. example: F00214431 lei: type: string description: >- Legal Entity Identifier (LEI): 20 uppercase alphanumeric characters, ending with 2 digits Returned when a company identifier uniquely matches a GLEIF registration or validation reference. Coverage varies by jurisdiction and entity. Lapsed and retired LEIs may be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 - title: US-MS type: object properties: businessId: type: string description: >- Business ID: Digits only, no separators and no leading zeros. 6 or 7 digits in the records we have seen (e.g. 104297, 1001743). Unique identifier assigned by the Mississippi Secretary of State to each registered business entity. example: '104297' lei: type: string description: >- Legal Entity Identifier (LEI): 20 uppercase alphanumeric characters, ending with 2 digits Returned when a company identifier uniquely matches a GLEIF registration or validation reference. Coverage varies by jurisdiction and entity. Lapsed and retired LEIs may be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 - title: US-MT type: object properties: entityId: type: string description: >- Montana SoS File Number: One or two uppercase letters followed by 6 or 7 digits, no separator, leading zeros included (e.g. F022568, C1548288, RN1064026). In the records we have seen: C (domestic LLC), E (foreign LLC), D (domestic corporation, profit or nonprofit, e.g. D002784, D1137652), F (foreign corporation), L (limited partnership), A (assumed business name) and RN (name reservation); P and N are also in use. The list is not closed. State correspondence may print the number with a hyphen after the letter (D-123456); the API returns it without. Primary identifier assigned by the Montana Secretary of State at entity formation or qualification, published on the biz.sosmt.gov portal as the Filing Number. Pass it without a hyphen, exactly as a search result returns it. example: F022568 lei: type: string description: >- Legal Entity Identifier (LEI): 20 uppercase alphanumeric characters, ending with 2 digits Returned when a company identifier uniquely matches a GLEIF registration or validation reference. Coverage varies by jurisdiction and entity. Lapsed and retired LEIs may be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 - title: US-NC type: object properties: sosId: type: string description: >- SOS ID: Exactly 7 digits, no separators, left-padded with zeros (e.g. 0027238, 3395486). Every id in the records we have seen has 7 digits. Primary identifier assigned by the North Carolina Secretary of State at entity formation or qualification, called the Secretary of State Identification Number (SOSID) on sosnc.gov. Search and company lookups also accept the number without its leading zeros. example: '0027238' lei: type: string description: >- Legal Entity Identifier (LEI): 20 uppercase alphanumeric characters, ending with 2 digits Returned when a company identifier uniquely matches a GLEIF registration or validation reference. Coverage varies by jurisdiction and entity. Lapsed and retired LEIs may be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 - title: US-ND type: object properties: entityId: type: string description: >- SOS Control ID#: Exactly 10 digits, no separators, left-padded with zeros (e.g. 0000071213, 0007382449). Every id in the records we have seen has 10 digits. Primary identifier assigned by the North Dakota Secretary of State at filing time. Unique across all filing types (corporations, LLCs, trade names, trademarks, reserved names). Search and company lookups also accept the number without its leading zeros. example: '0000071213' ndInternalId: type: string description: >- FirstStop Internal ID: Digits only, no padding (e.g. 70993). A different number from the SOS Control ID#: the two cannot be derived from each other. Portal-internal identifier used by the FirstStop system to navigate to the entity detail page. Not a public register identifier. example: '70993' lei: type: string description: >- Legal Entity Identifier (LEI): 20 uppercase alphanumeric characters, ending with 2 digits Returned when a company identifier uniquely matches a GLEIF registration or validation reference. Coverage varies by jurisdiction and entity. Lapsed and retired LEIs may be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 - title: US-NE type: object properties: accountNumber: type: string description: >- SOS Account Number: Digits only, no separators. Three lengths in the records we have seen: 7 digits, often starting with zeros that are part of the number (e.g. 0527041, 1274939), 8 digits (e.g. 10214668) and 10 digits (e.g. 2103077754). Primary identifier assigned by the Nebraska Secretary of State, Business Services Division. Pass it exactly as a search result returns it, leading zeros included. example: '10214668' lei: type: string description: >- Legal Entity Identifier (LEI): 20 uppercase alphanumeric characters, ending with 2 digits Returned when a company identifier uniquely matches a GLEIF registration or validation reference. Coverage varies by jurisdiction and entity. Lapsed and retired LEIs may be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 - title: US-NH type: object properties: entityId: type: string description: >- NH Business ID: Two forms, no separators. Most entities: digits only, variable length, no leading zeros; 5 to 7 digits in the records we have seen (e.g. 39831, 848218, 1026301). Some older corporations: the letter B followed by 5 digits (e.g. B02109). Primary identifier assigned by the New Hampshire Department of State at filing time, also called the Charter Number. Unique across all entity types: corporations, limited liability companies, limited partnerships, trade names and trademarks share the same number space. Pass it exactly as a search result returns it, including the letter of a B-prefixed ID. example: '848218' lei: type: string description: >- Legal Entity Identifier (LEI): 20 uppercase alphanumeric characters, ending with 2 digits Returned when a company identifier uniquely matches a GLEIF registration or validation reference. Coverage varies by jurisdiction and entity. Lapsed and retired LEIs may be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 - title: US-NJ type: object properties: entityId: type: string description: >- NJ Entity ID: Exactly 10 digits, no separators. Leading zeros are part of the number: most ids we have seen start with 0 (e.g. 0100307257, 0400276378), some do not (e.g. 6444850000). The register does not accept a shortened form. Primary identifier assigned by the New Jersey Division of Revenue and Enterprise Services (DORES). Used to look up filings on the DORES public portal and to order business records. example: '0100307257' lei: type: string description: >- Legal Entity Identifier (LEI): 20 uppercase alphanumeric characters, ending with 2 digits Returned when a company identifier uniquely matches a GLEIF registration or validation reference. Coverage varies by jurisdiction and entity. Lapsed and retired LEIs may be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 - title: US-NM type: object properties: businessId: type: string description: >- NM SOS Business ID: Observed forms, none with separators. Most entities: 3 to 10 digits, where modern IDs are zero-padded to 10 digits and the leading zeros are significant (e.g. 913, 1166917, 0008058504). Many partnerships: a letter prefix followed by 10 digits (e.g. LPD2005092001); prefixes in use are LPD and LPF (limited partnership, domestic and foreign), GPD (general partnership), LLD (limited liability partnership), LLLD and LLLF (limited liability limited partnership, domestic and foreign). Some older limited partnerships: 4 digits followed by NM (e.g. 0806NM). Historical bank records also carry 3 or 4 digits followed by A (e.g. 323A, 2352A). Primary identifier assigned by the New Mexico Secretary of State and published on the register as the Business ID. Pass it exactly as a search result returns it. The register does not resolve the observed NM-suffixed and A-suffixed numbers through its ID search: those records appear in name search results, but company lookup by those IDs and documents are currently unavailable. Trade Register Extracts are available for numeric IDs of 3 to 10 digits and letter-prefixed partnership IDs. example: '2070134' lei: type: string description: >- Legal Entity Identifier (LEI): 20 uppercase alphanumeric characters, ending with 2 digits Returned when a company identifier uniquely matches a GLEIF registration or validation reference. Coverage varies by jurisdiction and entity. Lapsed and retired LEIs may be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 - title: US-NV type: object properties: entityNumber: type: string description: >- Entity Number: An uppercase letter prefix, digits, a hyphen and a numeric suffix, no spaces. Two forms in the records we have seen. Current numbering: E followed by 10 or 11 digits, a hyphen and 1 digit (e.g. E0082262010-4, E40614102024-7). Older entities: a letter prefix (C, LLC and LP seen so far), up to 5 digits, a hyphen and 4 digits (e.g. C40-1921, C14059-2002, LLC1688-2002, LP38-1987). The register publishes no list of prefixes, so treat the set as open. Primary identifier assigned by the Nevada Secretary of State and shown as the Entity Number on the register. Pass it exactly as a search result returns it: the letters and the hyphenated suffix are part of the number. example: LLC1688-2002 nvBusinessId: type: string description: >- NV Business ID: NV followed by 11 digits, no separators (e.g. NV20021018811). Cross-agency identifier shared between the Secretary of State and the Nevada Department of Taxation. Not present on all entities. example: NV20021018811 lei: type: string description: >- Legal Entity Identifier (LEI): 20 uppercase alphanumeric characters, ending with 2 digits Returned when a company identifier uniquely matches a GLEIF registration or validation reference. Coverage varies by jurisdiction and entity. Lapsed and retired LEIs may be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 - title: US-NY type: object properties: dosId: type: string description: >- DOS ID: Numeric, 1 to 7 digits, no leading zeros. Most entities have 6 or 7 digits; the oldest have fewer (e.g. 3707). Primary identifier assigned by the New York Department of State Division of Corporations. Visible on every NY DOS Public Inquiry entity detail page and used to look up filings on data.ny.gov. example: '2494465' lei: type: string description: >- Legal Entity Identifier (LEI): 20 uppercase alphanumeric characters, ending with 2 digits Returned when a company identifier uniquely matches a GLEIF registration or validation reference. Coverage varies by jurisdiction and entity. Lapsed and retired LEIs may be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 - title: US-OH type: object properties: ohioId: type: string description: >- Ohio Charter / Entity Number: Observed numeric forms: 4 to 7 digits; none of the sampled numeric IDs had a leading zero (e.g. 1456, 693950, 2420083). Registered trade names and a few older or special registrations carry letters: two letters followed by digits (e.g. RN228652, FN31251, LP3159), or digits followed by one letter (e.g. 14276Z). Primary identifier assigned by the Ohio Secretary of State. Corresponds to the charter_num field on the public business search portal (businesssearch.ohiosos.gov) and the charter number column in the monthly Business Reports. These are observed formats, not an exhaustive register specification. Preserve the returned string, including its letters and any leading zeros; do not pad it to a fixed width. example: '1067403' lei: type: string description: >- Legal Entity Identifier (LEI): 20 uppercase alphanumeric characters, ending with 2 digits Returned when a company identifier uniquely matches a GLEIF registration or validation reference. Coverage varies by jurisdiction and entity. Lapsed and retired LEIs may be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 - title: US-OK type: object properties: filingNumber: type: string description: >- Filing Number: 10 digits, numeric only Primary identifier assigned by the Oklahoma Secretary of State. Displayed on every entity page at sos.ok.gov/corp and used for all register lookups. example: '3400676484' lei: type: string description: >- Legal Entity Identifier (LEI): 20 uppercase alphanumeric characters, ending with 2 digits Returned when a company identifier uniquely matches a GLEIF registration or validation reference. Coverage varies by jurisdiction and entity. Lapsed and retired LEIs may be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 - title: US-OR type: object properties: registryNumber: type: string description: >- Registry Number: Digits, with a hyphen before the last 2 digits for most entities; 3 to 9 digits in total. Most entities: 6 or 7 digits, a hyphen and 2 digits, where the part before the hyphen is zero-padded to 6 digits (e.g. 087399-14, 1496294-95). Some search results carry that part without its leading zero (e.g. 12267-11 for 012267-11). Some entities: 3 to 6 digits with no hyphen (e.g. 414, 443499). The register's open data stores the same numbers as digits only, without the hyphen or leading zeros (e.g. 8739914). Primary identifier assigned by the Oregon Secretary of State Corporation Division and shown as the Registry Number on the Oregon Business Registry. Accepted with or without the hyphen and leading zeros (087399-14, 08739914 and 8739914 resolve to the same entity); responses use the hyphenated form, or the plain digits for numbers under 7 digits. example: 087399-14 lei: type: string description: >- Legal Entity Identifier (LEI): 20 uppercase alphanumeric characters, ending with 2 digits Returned when a company identifier uniquely matches a GLEIF registration or validation reference. Coverage varies by jurisdiction and entity. Lapsed and retired LEIs may be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 - title: US-PA type: object properties: filingNumber: type: string description: >- PA Filing Number: 10 digits, numeric only, with leading zeros preserved (e.g. 0004272272). Primary identifier assigned by the Pennsylvania Department of State. Used to look up entity detail on the Business Filing Services portal and to search the open-data register at data.pa.gov. example: '0004272272' lei: type: string description: >- Legal Entity Identifier (LEI): 20 uppercase alphanumeric characters, ending with 2 digits Returned when a company identifier uniquely matches a GLEIF registration or validation reference. Coverage varies by jurisdiction and entity. Lapsed and retired LEIs may be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 - title: US-RI type: object properties: identificationNumber: type: string description: >- RI Identification Number: Nine-digit zero-padded number (e.g. 000015908) Primary identifier assigned by the Rhode Island Department of State Business Services Division to each entity in the Corporate Database. example: '000015908' lei: type: string description: >- Legal Entity Identifier (LEI): 20 uppercase alphanumeric characters, ending with 2 digits Returned when a company identifier uniquely matches a GLEIF registration or validation reference. Coverage varies by jurisdiction and entity. Lapsed and retired LEIs may be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 - title: US-SC type: object properties: guid: type: string description: >- SC SoS Entity GUID: UUID (8-4-4-4-12 hex, lowercase), assigned by the SC Secretary of State Business Entities Online portal and used as the URL key on every entity profile page. Primary identifier assigned by the SC Secretary of State Business Entities Online portal. Visible in every entity profile URL at businessfilings.sc.gov and used for direct entity lookups. example: e6980025-c7ec-4715-8bf0-52b5ef0c585f entityId: type: string description: >- SC SoS Entity Id: 8-digit zero-padded integer displayed on the entity profile page. Not accepted as a search input by the public portal. Printed on filed paper documents; returned in `company.identifiers.entityId` so customers can reconcile against their own paperwork. NOT accepted as a lookup input: the SC portal search matches entity names only, so Topograph API calls use the GUID. example: '00121743' lei: type: string description: >- Legal Entity Identifier (LEI): 20 uppercase alphanumeric characters, ending with 2 digits Returned when a company identifier uniquely matches a GLEIF registration or validation reference. Coverage varies by jurisdiction and entity. Lapsed and retired LEIs may be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 - title: US-SD type: object properties: businessId: type: string description: >- Business ID: Exactly 8 characters, no separators: two uppercase letters followed by 6 digits, leading zeros included (e.g. FB033693, DL025748, NS000956). Prefixes seen in our search results: DL, NS, DB, FB, FL, FP, FK, BK, CH, DP, DR, RN, RS, DM, DT, GP and FN; the list is not closed. The register does not publish what the letters mean. Primary identifier assigned by the South Dakota Secretary of State and shown as the Business ID on the register. Pass it exactly as a search result returns it: the two letters and the leading zeros are part of the number. example: FB033693 lei: type: string description: >- Legal Entity Identifier (LEI): 20 uppercase alphanumeric characters, ending with 2 digits Returned when a company identifier uniquely matches a GLEIF registration or validation reference. Coverage varies by jurisdiction and entity. Lapsed and retired LEIs may be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 - title: US-TN type: object properties: controlNumber: type: string description: >- Control Number: 9-digit zero-padded number assigned by the Tennessee Secretary of State at registration. Accepted as 9 consecutive digits (000239194) or without leading zeros (239194). Primary identifier assigned by the Tennessee Secretary of State. Visible on every entity detail page at tncab.tnsos.gov. example: '000239194' lei: type: string description: >- Legal Entity Identifier (LEI): 20 uppercase alphanumeric characters, ending with 2 digits Returned when a company identifier uniquely matches a GLEIF registration or validation reference. Coverage varies by jurisdiction and entity. Lapsed and retired LEIs may be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 - title: US-TX type: object properties: taxpayerId: type: string description: >- Texas Taxpayer Number: 11 digits, no separators. The first digit is 1 when the number is built on the entity's federal EIN (the next nine digits are the EIN, e.g. 17307175087) and 3 when the Comptroller assigned it (e.g. 32041800429, 30003761332). The last digit is a check digit. Primary identifier assigned by the Texas Comptroller of Public Accounts. Used as the lookup key for both the Franchise Tax and Sales Tax Comptroller systems. Every search result id is a taxpayer number, whichever identifier was searched: use it on /v2/company. example: '17307175087' sosFileNumber: type: string description: >- SOS Filing Number: 10 digits, zero-padded, leading zeros included (e.g. 0803367205, 0003077806). The Secretary of State displays the same number without the leading zeros (803367205, 3077806). In the records we have seen, recent filings start with 080. Filing number assigned by the Texas Secretary of State. Only present for formal entities (corporations, LLCs, limited partnerships and similar); absent for sole traders and sales-tax-only taxpayers. Search accepts it padded or as the Secretary of State displays it (0803367205 or 803367205, 0003077806 or 3077806). The search result id is the taxpayer number. example: '0003077806' feiNumber: type: string description: >- Federal Employer Identification Number: The 9-digit federal EIN as recorded by the Comptroller, without a separator (e.g. 730717508). For a taxpayer number that starts with 1, it is normally the second to tenth digits of that number. Federal Employer Identification Number (FEIN / EIN) as recorded in the Texas Comptroller and Secretary of State systems. Only present when the entity has a FEIN on file; absent for sole traders who registered without one. example: '730717508' stateOfFormation: type: string description: >- State of Formation: Two-letter US state code or "TX" for domestic entities (e.g. TX, NJ, DE) US state in which the entity was originally formed, as recorded in the Franchise Tax system. Only present when reported by the Comptroller. example: TX sosRegistrationStatus: type: string description: >- SOS Registration Status: Short status string from the Comptroller (e.g. ACTIVE, INACTIVE, NOT REGISTERED) Raw SOS registration status label from the Texas Comptroller Franchise Tax system, returned in prefill mode. Redundant with the top-level company status field but included here for completeness when present. example: ACTIVE lei: type: string description: >- Legal Entity Identifier (LEI): 20 uppercase alphanumeric characters, ending with 2 digits Returned when a company identifier uniquely matches a GLEIF registration or validation reference. Coverage varies by jurisdiction and entity. Lapsed and retired LEIs may be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 - title: US-UT type: object properties: entityNumber: type: string description: >- Utah Entity Number: 6 to 8 digits, a hyphen, then 4 digits, with no letters (e.g. 616169-0140, 7228568-0140, 10110445-0143). The four digits after the hyphen follow the entity type: in the records we have seen, -0140 is a domestic nonprofit corporation, -0151 an assumed name (DBA) and -0181 a foreign limited partnership; other values in use include -0141, -0142, -0143, -0150, -0160 and -0161, and the list is not closed. Primary identifier assigned by the Utah Division of Corporations & Commercial Code and shown as the Entity Number on businessregistration.utah.gov. Every id we return carries the hyphen and the four-digit suffix; the digits before the hyphen alone are also accepted as input. example: 616169-0140 lei: type: string description: >- Legal Entity Identifier (LEI): 20 uppercase alphanumeric characters, ending with 2 digits Returned when a company identifier uniquely matches a GLEIF registration or validation reference. Coverage varies by jurisdiction and entity. Lapsed and retired LEIs may be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 - title: US-VA type: object properties: entityId: type: string description: >- SCC ID: 8 characters, no separators, in two forms. One uppercase letter followed by 7 digits (e.g. S0381378, T0479784, F1389198, L0007460, M0093452). Or 8 digits with leading zeros kept (e.g. 02937985, 00003145, 11127380): older corporations carry this form, and so do recent registrations of every entity type, LLCs and limited partnerships included. In the records we have seen, the letter follows the filing family: S (Virginia LLC), T (foreign LLC), F (foreign corporation), L (Virginia limited partnership, and some LLCs), M (foreign limited partnership), J (a few LLCs). The register publishes no meaning for the letters, and the list is not closed. Primary identifier assigned by the Virginia State Corporation Commission, shown as the Entity ID (or SCC ID) in the Clerk's Information System at cis.scc.virginia.gov. Pass it exactly as a search result returns it, letter and leading zeros included. example: '02937985' lei: type: string description: >- Legal Entity Identifier (LEI): 20 uppercase alphanumeric characters, ending with 2 digits Returned when a company identifier uniquely matches a GLEIF registration or validation reference. Coverage varies by jurisdiction and entity. Lapsed and retired LEIs may be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 - title: US-VT type: object properties: entityId: type: string description: >- Record Number: Always 6 digits, zero-padded, leading zeros included (e.g. 074657, 001020, 487831). Primary identifier assigned by the Vermont Secretary of State when the entity is filed. Unique across all filing types (corporations, LLCs, partnerships, assumed names, etc.). Accepted with or without the leading zeros; every id we return carries the 6-digit form. example: '074657' vtIdBusiness: type: string description: >- VT Internal Business ID: UUID, 36 characters with hyphens, lowercase in the records we have seen (e.g. 79304417-fb3e-4bd0-8dda-1a005071a37a) The register's internal key for the entity, returned alongside the Record Number for reference. It cannot be used to search or to request a company: use the Record Number. example: 79304417-fb3e-4bd0-8dda-1a005071a37a lei: type: string description: >- Legal Entity Identifier (LEI): 20 uppercase alphanumeric characters, ending with 2 digits Returned when a company identifier uniquely matches a GLEIF registration or validation reference. Coverage varies by jurisdiction and entity. Lapsed and retired LEIs may be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 - title: US-WA type: object properties: ubi: type: string description: >- UBI (Unified Business Identifier): Always 9 digits, returned without separators (e.g. 600413485, 606026013, 178005030). The register displays it in groups of three (600 413 485); search and company requests also accept the dashed form (600-413-485). The same UBI cross-references the entity across the Secretary of State, Department of Revenue, Labor & Industries, and Employment Security. Primary identifier assigned by the Washington Business Licensing Service. example: '600413485' fein: type: string description: >- FEIN (Federal Employer Identification Number): The 9-digit federal EIN as recorded on the Secretary of State entity profile (e.g. 911144442) Returned when present on the Secretary of State entity profile. Not all entities carry a FEIN. example: '911144442' lei: type: string description: >- Legal Entity Identifier (LEI): 20 uppercase alphanumeric characters, ending with 2 digits Returned when a company identifier uniquely matches a GLEIF registration or validation reference. Coverage varies by jurisdiction and entity. Lapsed and retired LEIs may be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 - title: US-WI type: object properties: entityId: type: string description: >- Wisconsin DFI Entity ID: Seven characters: one alpha plus six numerics, accepted in two shapes : modern `A######` (one letter then six digits) or legacy `#A#####` (one digit, one letter, then five digits). Primary identifier assigned by the Wisconsin Department of Financial Institutions. Visible on every WDFI Corporate Records Search entity detail page. example: K024598 lei: type: string description: >- Legal Entity Identifier (LEI): 20 uppercase alphanumeric characters, ending with 2 digits Returned when a company identifier uniquely matches a GLEIF registration or validation reference. Coverage varies by jurisdiction and entity. Lapsed and retired LEIs may be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 - title: US-WV type: object properties: orgNumber: type: string description: >- WV Organization Number: Digits only, with no leading zeros, letters or separators. In the records we have seen it has 4 to 6 digits (e.g. 2011, 20122, 633785). Primary identifier assigned by the West Virginia Secretary of State (the "Org Id"). Used to key the entity detail page directly on the Online Data Services portal. example: '20122' lei: type: string description: >- Legal Entity Identifier (LEI): 20 uppercase alphanumeric characters, ending with 2 digits Returned when a company identifier uniquely matches a GLEIF registration or validation reference. Coverage varies by jurisdiction and entity. Lapsed and retired LEIs may be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 - title: US-WY type: object properties: filingId: type: string description: >- Filing ID: YYYY-NNNNNNNNN: a 4-digit year prefix, a dash, and a 9-digit zero-padded sequence number issued by the Wyoming Secretary of State upon entity registration. Primary identifier assigned by the Wyoming Secretary of State. Visible on every WyoBiz entity detail page and used as the lookup key on wyobiz.wyo.gov. example: 2004-000464709 lei: type: string description: >- Legal Entity Identifier (LEI): 20 uppercase alphanumeric characters, ending with 2 digits Returned when a company identifier uniquely matches a GLEIF registration or validation reference. Coverage varies by jurisdiction and entity. Lapsed and retired LEIs may be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 example: VAT: '02580590541' required: - matchType MatchType: type: string enum: - id - exactLegalName - partialId - default description: >- The type of match that produced this result. "id" means a guaranteed 1:1 match from an ID-based search (e.g., VAT number, CCIAA+REA). "exactLegalName" means the legal name exactly matches the search query. "partialId" means matched by a partial identifier that is not guaranteed unique (e.g., REA without CCIAA). "default" is used when the exact matching criteria is unknown. Results are ordered: id > exactLegalName > partialId > default. AntiguaBarbudaIdentifiers: type: object properties: lei: type: string description: >- Legal Entity Identifier from GLEIF, returned when an existing company identifier uniquely matches a GLEIF registration or validation reference. Absent when no unambiguous identifier match is available. Lapsed and retired LEIs can be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 pattern: ^[A-Z0-9]{18}[0-9]{2}$ entityNumber: type: string description: >- Entity Number issued by the Antigua and Barbuda Intellectual Property and Commerce Office (IPCO). Format: an uppercase "C", sometimes followed by a space, then 1 to 4 digits, optionally followed by a slash and a 2- or 4-digit year; with a 4-digit year the number is zero-padded to 4 digits. Examples: "C8093", "C84/09", "C0728/2025", "C 2836". Pass it exactly as returned, space included. example: C8093 description: Identifiers for Antigua and Barbuda companies (AG) ItalyIdentifiers: type: object properties: lei: type: string description: >- Legal Entity Identifier from GLEIF, returned when an existing company identifier uniquely matches a GLEIF registration or validation reference. Absent when no unambiguous identifier match is available. Lapsed and retired LEIs can be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 pattern: ^[A-Z0-9]{18}[0-9]{2}$ euid: type: string description: >- European Unique Identifier, derived from the register tax code for supported Italian limited companies. example: ITRI.00484960588 VAT: type: string description: >- Partita IVA (P.IVA) - VAT registration number. Format: 11 digits, the last a check digit, without the IT prefix (e.g., "00905811006"). Usually equal to the company codice fiscale, but not always. Issued by: Agenzia delle Entrate (Revenue Agency) example: '00905811006' codiceFiscale: type: string description: >- Codice Fiscale - Tax identification code. Format: 11 digits for companies, the last a check digit (e.g., "00484960588"), or, for a sole proprietorship, the 16-character personal codice fiscale of the owner (e.g., "BRNLSN75H27B564E"). Issued by: Agenzia delle Entrate (Revenue Agency) example: '00484960588' cciaa: type: string description: >- CCIAA - Camera di Commercio (Chamber of Commerce) province code. Format: 2-letter province code (e.g., "RM" for Roma, "MI" for Milano). Indicates which Chamber of Commerce the company is registered with. example: RM rea: type: string description: >- REA number - Registro Economico Amministrativo (Economic Administrative Register) number. Format: 1 to 7 digits (e.g., "756453"). Unique within each CCIAA province. Combined with CCIAA forms a unique identifier. example: '756453' Codice Fiscale: type: string deprecated: true description: >- Deprecated legacy alias of `codiceFiscale` — use `codiceFiscale`. Emitted until 2026-09-01. example: '00484960588' CCIAA: type: string deprecated: true description: >- Deprecated legacy alias of `cciaa` — use `cciaa`. Emitted until 2026-09-01. example: RM REA Code: type: string deprecated: true description: >- Deprecated legacy alias of `rea` — use `rea`. Emitted until 2026-09-01. example: '756453' description: Identifiers for Italian companies (IT) FranceIdentifiers: type: object properties: lei: type: string description: >- Legal Entity Identifier from GLEIF, returned when an existing company identifier uniquely matches a GLEIF registration or validation reference. Absent when no unambiguous identifier match is available. Lapsed and retired LEIs can be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 pattern: ^[A-Z0-9]{18}[0-9]{2}$ siren: type: string description: >- SIREN - Système d'Identification du Répertoire des Entreprises. Format: 9 digits, leading zeros significant (e.g., "443061841", "085880458"); the ninth digit is a check digit (Luhn). Issued by: INSEE (Institut National de la Statistique et des Études Économiques). This is the primary company identifier in France. example: '443061841' siret: type: string description: >- SIRET - Système d'Identification du Répertoire des Établissements. Format: 14 digits = SIREN (9) + NIC (5) (e.g., "44306184100047"); the last digit is a check digit. Identifies a specific establishment (location) of a company, normally the head office. Issued by: INSEE. example: '44306184100047' VAT: type: string description: >- TVA Intracommunautaire - French VAT number. Format: 11 digits, a 2-digit key followed by the SIREN (e.g., "64443061841"); the FR prefix is stripped in the response. Issued by: Direction Générale des Finances Publiques (DGFiP). Required for EU cross-border transactions. example: '64443061841' rna: type: string description: >- RNA - Répertoire National des Associations. Waldec associations use "W" + 9 characters: 9 digits (e.g., "W073000441"), or in Corsica 2A/2B + 7 digits. Older RNA-Import associations use up to 15 letters, digits and hyphens, typically 3 digits, a letter, then digits (e.g., "332P2214500", "051S00-011"). Every RNA id contains an uppercase letter. Alsace-Moselle associations carry one only when the register records it. Issued by: Préfecture. example: W073000441 rnaAlsaceMoselle: type: string description: >- RNA Alsace-Moselle (AMALIA number) - identifier for associations registered under local law (droit local) in the Alsace-Moselle region. Format: 14 characters, A + 4 digits (usually the year of registration) + 3-letter court code + 6 digits (e.g., "A2002THI000075"). This is the id search returns for these associations. example: A2002THI000075 description: Identifiers for French companies (FR) AustriaIdentifiers: type: object properties: lei: type: string description: >- Legal Entity Identifier from GLEIF, returned when an existing company identifier uniquely matches a GLEIF registration or validation reference. Absent when no unambiguous identifier match is available. Lapsed and retired LEIs can be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 pattern: ^[A-Z0-9]{18}[0-9]{2}$ firmenbuchnummer: type: string description: >- Firmenbuchnummer - Company registration number. Format: digits followed by a lowercase check letter, no space (e.g., "184018s"). Issued by: Firmenbuch (Company Register). example: 184018s VAT: type: string description: >- VAT number (USt-IdNr/UID) without ATU prefix. Format: U + 8 digits, the last one a check digit (e.g., "U47318406"). Full format: ATU47318406. Note: VAT number is not derivable from Firmenbuchnummer and must be obtained separately. example: U47318406 zvrNumber: type: string description: >- ZVR number (Vereinsregisternummer) — Central Association Register number. Format: 1-10 digits (e.g., "432857691"). Issued by: Zentrales Vereinsregister (BMI). example: '432857691' gisaZahl: type: string description: >- GISA-Zahl — Trade licence number from the Austrian Trade Information System. Format: digits, 8 in every record we have seen (e.g., "10118573"). Issued by: GISA (Gewerbeinformationssystem Austria). example: '10118573' euid: type: string description: >- EUID (European Unique Identifier) — Cross-border company identifier assigned by the Firmenbuch under the EU Company Law Directive. Format: ATBRA. + the Firmenbuch number padded to 6 digits without its check letter + -000 (e.g., "ATBRA.184018-000"). Issued by: Firmenbuch (Company Register). example: ATBRA.184018-000 EUID: type: string deprecated: true description: >- Deprecated legacy alias of `euid` — use `euid`. Emitted until 2026-09-01. example: ATBRA.184018-000 description: Identifiers for Austrian companies (AT) BelgiumIdentifiers: type: object properties: lei: type: string description: >- Legal Entity Identifier from GLEIF, returned when an existing company identifier uniquely matches a GLEIF registration or validation reference. Absent when no unambiguous identifier match is available. Lapsed and retired LEIs can be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 pattern: ^[A-Z0-9]{18}[0-9]{2}$ euid: type: string description: >- European Unique Identifier, derived for supported domestic company forms from the national register number. example: BEKBOBCE.0403.170.701 ondernemingsnummer: type: string description: >- Enterprise Number (Ondernemingsnummer) - Unique identifier for Belgian companies. Format: 10 digits, returned with dots as NNNN.NNN.NNN (e.g., "0403.170.701"). The first digit is 0 or 1 (numbers issued since September 2023 start with 1); the last two digits are check digits (97 minus the first eight digits modulo 97). Issued by: Crossroads Bank for Enterprises (CBE). example: 0403.170.701 VAT: type: string description: >- VAT number (BTW nummer) without BE prefix. In Belgium, the VAT number equals the enterprise number (10 digits starting with 0 or 1). Format: 10 digits, no dots (e.g., "0403170701"). Full format: BE0403170701. Derived from the enterprise number, so it is returned whether or not the entity is registered for VAT. example: '0403170701' Numéro BCE: type: string deprecated: true description: >- Deprecated legacy alias of `ondernemingsnummer` — use `ondernemingsnummer`. Emitted until 2026-09-01. example: 0425.258.688 description: Identifiers for Belgian companies (BE) BrazilIdentifiers: type: object properties: lei: type: string description: >- Legal Entity Identifier from GLEIF, returned when an existing company identifier uniquely matches a GLEIF registration or validation reference. Absent when no unambiguous identifier match is available. Lapsed and retired LEIs can be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 pattern: ^[A-Z0-9]{18}[0-9]{2}$ cnpj: type: string description: >- Cadastro Nacional da Pessoa Jurídica (CNPJ), issued by Receita Federal. 14 characters: 12 uppercase letters A–Z or digits followed by two numeric check digits. Existing numeric CNPJs remain valid. Returned without punctuation, retaining leading zeros; formatted input such as 00.000.000/E08G-12 is accepted. Each establishment has its own CNPJ. example: '19131243000197' description: Identifiers for Brazilian entities (BR) SwitzerlandIdentifiers: type: object properties: lei: type: string description: >- Legal Entity Identifier from GLEIF, returned when an existing company identifier uniquely matches a GLEIF registration or validation reference. Absent when no unambiguous identifier match is available. Lapsed and retired LEIs can be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 pattern: ^[A-Z0-9]{18}[0-9]{2}$ uid: type: string description: >- UID (Unternehmens-Identifikationsnummer) - Swiss company identification number. Format: CHE followed by 9 digits, without separators (e.g., "CHE408600128"); the register also writes it CHE-408.600.128. The last digit is a check digit (modulo 11). Issued by: Federal Statistical Office. example: CHE408600128 ehraId: type: string description: >- EHRA-ID - Internal identifier of the Swiss federal commercial-register central database. Format: 1 to 7 digits (e.g., "1499050"). Issued by: Federal Office of Justice (EHRA). example: '1499050' chId: type: string description: >- CH-ID - Former commercial-register number, no longer used in public. Format: CH followed by 11 digits, without separators (e.g., "CH55011976311"). example: CH55011976311 description: Identifiers for Swiss companies (CH) ChinaIdentifiers: type: object properties: lei: type: string description: >- Legal Entity Identifier from GLEIF, returned when an existing company identifier uniquely matches a GLEIF registration or validation reference. Absent when no unambiguous identifier match is available. Lapsed and retired LEIs can be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 pattern: ^[A-Z0-9]{18}[0-9]{2}$ uscc: type: string description: >- USCC (Unified Social Credit Code, 统一社会信用代码). Format: 18 characters, digits and uppercase letters (never I, O, S, V or Z), the last one a check character (e.g., "9144030071526726XG"). Some codes are all digits (e.g., "911000001000013428"). Issued by: the entity's registration authority, under national standard GB 32100-2015. example: 9144030071526726XG description: Identifiers for Chinese companies (CN) CyprusIdentifiers: type: object properties: lei: type: string description: >- Legal Entity Identifier from GLEIF, returned when an existing company identifier uniquely matches a GLEIF registration or validation reference. Absent when no unambiguous identifier match is available. Lapsed and retired LEIs can be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 pattern: ^[A-Z0-9]{18}[0-9]{2}$ registrationNumber: type: string description: >- Registration Number - Company registration number in Cyprus. Format: a prefix followed by 1 to 6 digits, no space, no leading zeros (e.g., "ΗΕ433437", "ΕΕ25556", "Σ2536", "ΑΕ1677", "BN1"). ΗΕ, ΕΕ, Σ and ΑΕ are Greek letters, not their Latin look-alikes; BN is Latin. The prefix is the entity type: ΗΕ company, ΕΕ business name, Σ partnership, ΑΕ overseas company, BN partnership registered as a business name. Issued by: Department of Registrar of Companies and Intellectual Property. example: ΗΕ433437 euid: type: string description: >- European Unique Identifier (EUID): CYDRCOR.HE + the registration number digits, HE in Latin letters. Available for domestic private and public limited companies. Older onboarding profiles may omit it. example: CYDRCOR.HE433437 description: Identifiers for Cypriot companies (CY) CzechiaIdentifiers: type: object properties: lei: type: string description: >- Legal Entity Identifier from GLEIF, returned when an existing company identifier uniquely matches a GLEIF registration or validation reference. Absent when no unambiguous identifier match is available. Lapsed and retired LEIs can be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 pattern: ^[A-Z0-9]{18}[0-9]{2}$ euid: type: string description: >- European Unique Identifier, derived for supported domestic company forms from the national register number. example: CZVROR.04234651 ico: type: string description: >- IČO (Identifikační číslo osoby) - Company identification number. Format: 8 digits, the last one a check digit (e.g., "45274649"). Issued by: Czech Statistical Office. example: '45274649' dic: type: string description: >- DIČ (Daňové identifikační číslo) - Tax identification number. Format: CZ prefix + 8-10 digits (e.g., "CZ45274649"). For companies, this is typically CZ + IČO. example: CZ45274649 VAT: type: string description: >- VAT number (DIČ) without CZ prefix. Format: 8-10 digits. For companies, this is typically the same as IČO. example: '45274649' description: Identifiers for Czech companies (CZ) GermanyIdentifiers: type: object properties: lei: type: string description: >- Legal Entity Identifier from GLEIF, returned when an existing company identifier uniquely matches a GLEIF registration or validation reference. Absent when no unambiguous identifier match is available. Lapsed and retired LEIs can be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 pattern: ^[A-Z0-9]{18}[0-9]{2}$ registerCourt: type: string description: >- The local court (Amtsgericht) that maintains the register entry. Together with registerType and registerNumber this forms the full German commercial-register identifier (e.g. "München" in "München HRB 228960"). example: München registerType: type: string description: >- The register section: HRB (Handelsregister B – capital companies), HRA (Handelsregister A – partnerships / sole traders), VR (Vereinsregister – associations), PR (Partnerschaftsregister), GnR (Genossenschaftsregister – cooperatives; GenR in a company id is returned as GnR), GsR (Gesellschaftsregister, registered civil-law partnerships). example: HRB registerNumber: type: string description: >- The register entry number (e.g. "228960" in "München HRB 228960"), up to 6 digits in the records we have seen, with any letter suffix the court adds kept after a space. example: '228960' VAT: type: string description: >- VAT identification number (USt-IdNr). Format: DE + 9 digits, the last a check digit. Issued by: Bundeszentralamt für Steuern. example: DE143454214 euid: type: string description: >- European Unique Identifier returned by the German commercial register when available. example: DED2601V.HRB180911 description: Identifiers for German companies (DE) DenmarkIdentifiers: type: object properties: lei: type: string description: >- Legal Entity Identifier from GLEIF, returned when an existing company identifier uniquely matches a GLEIF registration or validation reference. Absent when no unambiguous identifier match is available. Lapsed and retired LEIs can be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 pattern: ^[A-Z0-9]{18}[0-9]{2}$ euid: type: string description: >- European Unique Identifier, derived for supported domestic company forms from the national register number. example: DKCVR.25450442 cvr: type: string description: >- CVR Number (Central Business Register) - Company registration number. Format: 8 digits, no separators; the last digit is a modulus-11 check digit (e.g., "25450442"). Issued by: Danish Business Authority (Erhvervsstyrelsen). example: '25450442' VAT: type: string description: >- VAT number (Momsregistreringsnummer) without DK prefix. Format: 8 digits, identical to the CVR number. Returned for every entity, derived from the CVR number: its presence alone does not mean the entity is registered for VAT. example: '25450442' enhedsNummer: type: string description: >- Unit number (Enhedsnummer) - Internal CVR identifier for the business unit. Format: up to 10 digits (e.g., "4001459308"). Issued by: Danish Business Authority (Erhvervsstyrelsen). example: '4001459308' description: Identifiers for Danish companies (DK) EstoniaIdentifiers: type: object properties: lei: type: string description: >- Legal Entity Identifier from GLEIF, returned when an existing company identifier uniquely matches a GLEIF registration or validation reference. Absent when no unambiguous identifier match is available. Lapsed and retired LEIs can be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 pattern: ^[A-Z0-9]{18}[0-9]{2}$ euid: type: string description: >- European Unique Identifier, derived for supported domestic company forms from the national register number. example: EEARIREG.12417834 registryCode: type: string description: >- Registrikood - Registry code. Format: 8 digits, no separators or prefix (e.g., "12417834"). Issued by: Business Register (Äriregister). example: '12417834' VAT: type: string description: >- VAT number (KMKR number) without EE prefix. Format: 9 digits (e.g., "102090374"). Present when the Business Register lists a VAT number for the entity. example: '102090374' description: Identifiers for Estonian companies (EE) FinlandIdentifiers: type: object properties: lei: type: string description: >- Legal Entity Identifier from GLEIF, returned when an existing company identifier uniquely matches a GLEIF registration or validation reference. Absent when no unambiguous identifier match is available. Lapsed and retired LEIs can be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 pattern: ^[A-Z0-9]{18}[0-9]{2}$ businessId: type: string description: >- Business ID (Y-Tunnus) - Finnish business identification number. Format: 7 digits, hyphen, 1 modulus-11 check digit (e.g., "0112038-9"); leading zeros are significant. Issued by: Finnish Business Information System (YTJ). example: 0112038-9 VAT: type: string description: >- VAT number (ALV-numero) without FI prefix. Format: 8 digits (Business ID without hyphen). In Finland, VAT = FI + Business ID without dash. example: '01120389' euid: type: string description: >- European Unique Identifier returned by the Finnish Business Information System when available. example: FIFPRO.0112038-9 description: Identifiers for Finnish companies (FI) GuernseyIdentifiers: type: object properties: lei: type: string description: >- Legal Entity Identifier from GLEIF, returned when an existing company identifier uniquely matches a GLEIF registration or validation reference. Absent when no unambiguous identifier match is available. Lapsed and retired LEIs can be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 pattern: ^[A-Z0-9]{18}[0-9]{2}$ registryNumber: type: string description: >- Registry Number - registration number issued by the Guernsey Registry. Format: an uppercase letter prefix followed by digits, no space or leading zeros (e.g. "CMP10001", "LP2515", "FND167", "CH416", "NP69"). The prefix names the register: CMP (companies), LP (limited partnerships), LLP (limited liability partnerships), FND (foundations), CH (charities), NP (other non-profit organisations). Each register numbers its entities separately, so keep the prefix. example: CMP10001 description: Identifiers for Guernsey companies (GG) HongKongIdentifiers: type: object properties: lei: type: string description: >- Legal Entity Identifier from GLEIF, returned when an existing company identifier uniquely matches a GLEIF registration or validation reference. Absent when no unambiguous identifier match is available. Lapsed and retired LEIs can be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 pattern: ^[A-Z0-9]{18}[0-9]{2}$ brn: type: string description: >- BRN (Business Registration Number) - the Unique Business Identifier of a Hong Kong company. Format: 8 digits, leading zeros significant (e.g., "77054426"), or, for a company without a BRN, a dummy BRN of a letter prefix and 7 digits (e.g., "C1300723"). Issued by: Inland Revenue Department (Business Registration Office); dummy BRNs by the Companies Registry. example: '77054426' description: Identifiers for Hong Kong companies (HK) CroatiaIdentifiers: type: object properties: lei: type: string description: >- Legal Entity Identifier from GLEIF, returned when an existing company identifier uniquely matches a GLEIF registration or validation reference. Absent when no unambiguous identifier match is available. Lapsed and retired LEIs can be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 pattern: ^[A-Z0-9]{18}[0-9]{2}$ mbs: type: string description: >- MBS (Matični broj subjekta) - Company registration number. Format: 9 digits, leading zeros significant: a 2-digit court number, a 6-digit sequence number and a check digit (e.g., "010006782"). Issued by: Court Register (Sudski registar). example: '010006782' oib: type: string description: >- OIB (Osobni identifikacijski broj) - Tax identification number. Format: 11 digits, the last one a check digit (e.g., "09520995772"). Issued by: Tax Administration. example: '09520995772' VAT: type: string description: >- VAT number (PDV broj) without HR prefix. Format: 11 digits (same as OIB). In Croatia, OIB equals VAT number. example: '09520995772' mb: type: string description: >- MB (Matični broj) - Statistical registration number. Format: 8 digits at the register, returned as a number, so a leading zero is dropped (e.g., "03805131" is returned as "3805131"). Issued by: Croatian Bureau of Statistics (DZS). example: '03805131' euid: type: string description: >- EUID (European Unique Identifier) - cross-border BRIS identifier. Format: HRSR. followed by the 9-digit MBS (e.g., "HRSR.010006782"). Issued by: Court Register (Sudski registar) via BRIS. example: HRSR.010006782 description: Identifiers for Croatian companies (HR) HungaryIdentifiers: type: object properties: lei: type: string description: >- Legal Entity Identifier from GLEIF, returned when an existing company identifier uniquely matches a GLEIF registration or validation reference. Absent when no unambiguous identifier match is available. Lapsed and retired LEIs can be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 pattern: ^[A-Z0-9]{18}[0-9]{2}$ companyNumber: type: string description: >- Company Number (Cégjegyzékszám) - Company registration number issued by the Court of Registration. Format: 10 digits with no separators (e.g., "0109430929" for Cg. 01-09-430929): court code, company form code and 6-digit sequence number. example: '0109430929' taxNumber: type: string description: >- Tax Number (Adószám) - Full tax identification number. Format: 11 digits, usually written xxxxxxxx-y-zz (e.g., "32565144-2-41") and sometimes without hyphens. The first 8 digits form the EU VAT number (HU + first 8 digits). example: 32565144-2-41 VAT: type: string description: >- VAT number (ÁFA szám) without HU prefix. Format: First 8 digits of the tax number. In Hungary, VAT = HU + first 8 digits of tax number. example: '32565144' evnyRegistrationNumber: type: string description: >- EVNY Registration Number (Nyilvántartási szám) for sole traders. Format: 8 digits. Sole traders are registered in the EVNY registry, separate from the Cégjegyzék (company registry). example: '56109748' vatGroupNumber: type: string description: >- Group VAT number (Csoportos adószám) - Assigned when the company is part of a Hungarian VAT group. Both the regular tax number and this group tax number must appear on invoices. Format: xxxxxxxx-y-zz (11 digits with hyphens). Sourced from NAV (Hungarian Tax and Customs Authority). example: 17783666-5-41 statisticalCode: type: string description: >- Statistical code (KSH szám) - Identifier assigned by the Hungarian Central Statistical Office (KSH). Format: 17 digits, usually written 8-4-3-2 with hyphens (e.g., "32565144-4740-113-01"): tax base number, main activity code, economic form code and county code. Present for court-registered companies (from section 20 of the Cégkivonat) and for sole traders (from the EVNY registry). example: 32565144-4740-113-01 euid: type: string description: >- European Unique Identifier (EUID) - Cross-border identifier issued by the Hungarian Court of Registration. Format: HUOCCSZ.CC-TT-NNNNNN. Present for court-registered companies (from section 60 of the Cégkivonat). example: HUOCCSZ.01-09-430929 description: Identifiers for Hungarian companies (HU) IcelandIdentifiers: type: object properties: lei: type: string description: >- Legal Entity Identifier from GLEIF, returned when an existing company identifier uniquely matches a GLEIF registration or validation reference. Absent when no unambiguous identifier match is available. Lapsed and retired LEIs can be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 pattern: ^[A-Z0-9]{18}[0-9]{2}$ kennitala: type: string description: >- Kennitala (National ID / Registration number). Format: 10 digits, no separator (e.g., "5602151420"). For legal entities 40 is added to the day in the first two digits (41-71); a sole trader is identified by the personal kennitala of the owner (01-31). The 9th digit is a check digit, the 10th marks the century. Issued by: Skatturinn (Iceland Revenue and Customs) for entities in the company register. example: '5602151420' VAT: type: string description: >- VAT number (Virðisaukaskattsnúmer). 5 or 6 digits with no prefix in the records we have seen (e.g., "119978"), as issued by the Icelandic tax authority (Skatturinn). Present only when the register lists a VAT number for the entity. example: '119978' description: Identifiers for Icelandic companies (IS) IrelandIdentifiers: type: object properties: lei: type: string description: >- Legal Entity Identifier from GLEIF, returned when an existing company identifier uniquely matches a GLEIF registration or validation reference. Absent when no unambiguous identifier match is available. Lapsed and retired LEIs can be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 pattern: ^[A-Z0-9]{18}[0-9]{2}$ euid: type: string description: >- European Unique Identifier, derived for supported domestic company forms from the national register number. example: IECRO.368047 companyNumber: type: string description: >- Company Number - CRO registration number issued by the Companies Registration Office. Format: digits only, no leading zeros (1 to 6 digits in the records we have seen, e.g. "368047"). For a registered business name, search results and company.id carry the number with a "-B" suffix (e.g. "131910-B"), while this field carries the bare number. example: '368047' description: Identifiers for Irish companies (IE) IsleOfManIdentifiers: type: object properties: lei: type: string description: >- Legal Entity Identifier from GLEIF, returned when an existing company identifier uniquely matches a GLEIF registration or validation reference. Absent when no unambiguous identifier match is available. Lapsed and retired LEIs can be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 pattern: ^[A-Z0-9]{18}[0-9]{2}$ registrationNumber: type: string description: >- Company Registration Number issued by the Isle of Man Companies Registry (Department of Enterprise). Format: exactly 6 digits, zero-padded, followed by one uppercase letter that indicates the registry type (C = 1931 Act Company, V = 2006 Act Company, B = Business Name, F = Foreign Company, L = Limited Liability Company, M = Foundation; the Registry's other registers, such as industrial societies and limited partnerships, use other letters, e.g. "000006I"). Example: "099176C", "002092V". example: 099176C description: Identifiers for Isle of Man companies (IM) JerseyIdentifiers: type: object properties: lei: type: string description: >- Legal Entity Identifier from GLEIF, returned when an existing company identifier uniquely matches a GLEIF registration or validation reference. Absent when no unambiguous identifier match is available. Lapsed and retired LEIs can be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 pattern: ^[A-Z0-9]{18}[0-9]{2}$ companyNumber: type: string description: >- Jersey Entity Identifier - the JFSC registration number and entity id, hyphen-joined, digits only on both sides (e.g. "3499-3005057", "116051-300359"). Registered business names keep their RBN or BNT prefix (e.g. "BNT12894-168806"). The JFSC numbers each entity type in its own series, so a bare registration number can belong to several entities; the entity id disambiguates. example: 3499-3005057 description: Identifiers for Jersey companies (JE) LiechtensteinIdentifiers: type: object properties: lei: type: string description: >- Legal Entity Identifier from GLEIF, returned when an existing company identifier uniquely matches a GLEIF registration or validation reference. Absent when no unambiguous identifier match is available. Lapsed and retired LEIs can be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 pattern: ^[A-Z0-9]{18}[0-9]{2}$ flNumber: type: string description: >- FL-Nummer - Company registration number issued by the Office of Justice. Format: FL- followed by 10 digits grouped 4.3.3, a hyphen and a check digit (e.g., "FL-0001.548.501-4"). example: FL-0001.548.501-4 euid: type: string description: >- European Unique Identifier (EUID). Available in onboarding for Aktiengesellschaft companies with a confirmed register identity. example: LIFL.FL-0001.548.501-4 description: Identifiers for Liechtenstein companies (LI) LuxembourgIdentifiers: type: object properties: lei: type: string description: >- Legal Entity Identifier from GLEIF, returned when an existing company identifier uniquely matches a GLEIF registration or validation reference. Absent when no unambiguous identifier match is available. Lapsed and retired LEIs can be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 pattern: ^[A-Z0-9]{18}[0-9]{2}$ rcs: type: string description: >- RCS (Registre de Commerce et des Sociétés) - Company registration number. Format: one uppercase letter (the register section, A to O) followed by digits, with no space (e.g., "B246607", "F6", "K1206"). example: B246607 VAT: type: string description: >- VAT number (Numéro de TVA intracommunautaire) without LU prefix. Format: 8 digits (e.g., 32326416). example: '32326416' euid: type: string description: >- European Unique Identifier returned by the Luxembourg trade register when available. Format: LURCSL. followed by the RCS number (e.g., "LURCSL.B781"). example: LURCSL.B781 description: Identifiers for Luxembourg companies (LU) LatviaIdentifiers: type: object properties: lei: type: string description: >- Legal Entity Identifier from GLEIF, returned when an existing company identifier uniquely matches a GLEIF registration or validation reference. Absent when no unambiguous identifier match is available. Lapsed and retired LEIs can be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 pattern: ^[A-Z0-9]{18}[0-9]{2}$ euid: type: string description: >- European Unique Identifier (EUID). Returned for SIA and AS companies with a register-confirmed registration number and legal form. example: LVUR.50003090101 registrationNumber: type: string description: >- Registration Number - Company registration number. Format: digits only, no separators. Most entities: 11 digits (e.g., "50003090101"). Some older entries: 9 digits, leading zeros significant (e.g., "000307795"). Issued by: Register of Enterprises (Uzņēmumu reģistrs). example: '50003090101' foreignRegistrationNumber: type: string description: >- Foreign Registration Number - Home-country registration number of a foreign entity, as recorded by the Latvian register in the format of that home register (e.g., "930097705", a Norwegian organisation number). Returned for foreign entities recorded in the Register of Enterprises. example: '930097705' description: Identifiers for Latvian companies (LV) MonacoIdentifiers: type: object properties: lei: type: string description: >- Legal Entity Identifier from GLEIF, returned when an existing company identifier uniquely matches a GLEIF registration or validation reference. Absent when no unambiguous identifier match is available. Lapsed and retired LEIs can be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 pattern: ^[A-Z0-9]{18}[0-9]{2}$ rci: type: string description: >- RCI (Répertoire du Commerce et de l'Industrie) - Company registration number. Format: 8 characters, 2 digits + an uppercase letter + 5 digits (e.g., "99S03612", "18C21017", "80P04049"); leading zeros are significant. In the records we have seen, S is a commercial company, C a civil company, P a natural person trading in their own name. example: 99S03612 statisticalIdentificationNumber: type: string description: >- NIS (Numéro d'Identification Statistique) - Statistical identification number of the main establishment, issued by IMSEE. Format: 10 characters, the NAF activity code (4 digits + a letter) followed by a 5-digit sequence number (e.g., "6630Y08763"). example: 6630Y08763 description: Identifiers for Monégasque companies (MC) MaltaIdentifiers: type: object properties: lei: type: string description: >- Legal Entity Identifier from GLEIF, returned when an existing company identifier uniquely matches a GLEIF registration or validation reference. Absent when no unambiguous identifier match is available. Lapsed and retired LEIs can be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 pattern: ^[A-Z0-9]{18}[0-9]{2}$ registrationNumber: type: string description: >- Registration Number - Company registration number issued by the Malta Business Registry. Format: an entity-type prefix, a space, then digits (e.g., "C 2833", "P COMM 203"); former offshore companies are numbered "OS//T" or "OS//NT" (e.g., "OS/1116/NT"). example: C 2833 euid: type: string description: >- European Unique Identifier (EUID). Available for domestic private and public limited liability companies. example: MTROC.C2833 description: Identifiers for Maltese companies (MT) MauritiusIdentifiers: type: object properties: lei: type: string description: >- Legal Entity Identifier from GLEIF, returned when an existing company identifier uniquely matches a GLEIF registration or validation reference. Absent when no unambiguous identifier match is available. Lapsed and retired LEIs can be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 pattern: ^[A-Z0-9]{18}[0-9]{2}$ brn: type: string description: >- The CBRD File No.: one letter followed by up to 6 digits, exactly as issued (e.g. C117853, C067923); a zero after the letter is part of the number, not padding. The letter C marks a company. This is the identifier /v2/company accepts. It is distinct from the Business Registration Number (purely numeric, e.g. 125473, or one letter followed by 8 digits, e.g. C07068818), which identifies a business registration rather than the entity; an alphanumeric BRN, or an FSC global-business licence number such as 61811 C1/GBL, resolves to the File No. through /v2/search (a purely numeric BRN does not). example: C117853 description: Identifiers for Mauritian companies (MU) NetherlandsIdentifiers: type: object properties: lei: type: string description: >- Legal Entity Identifier from GLEIF, returned when an existing company identifier uniquely matches a GLEIF registration or validation reference. Absent when no unambiguous identifier match is available. Lapsed and retired LEIs can be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 pattern: ^[A-Z0-9]{18}[0-9]{2}$ euid: type: string description: >- European Unique Identifier, derived for supported domestic company forms from the national register number. example: NLNHR.34259528 kvk: type: string description: >- KVK (Kamer van Koophandel) - Chamber of Commerce number. Format: 8 digits, leading zeros significant (e.g., "39086858"). Issued by the Chamber of Commerce to every entity in the trade register, one per entity. example: '39086858' RSIN: type: string description: >- RSIN (Rechtspersonen en Samenwerkingsverbanden Informatienummer) - Legal Entities and Partnerships Information Number. Format: 9 digits (e.g., "813454554"). Assigned at registration in the trade register; sole traders (eenmanszaak) have none. For a legal entity, the VAT number is the RSIN followed by B and a 2-digit subnumber. example: '813454554' VAT: type: string description: >- VAT number (BTW nummer) without NL prefix. Format: 9 digits + B + 2-digit subnumber (e.g., "813454554B01"). For a legal entity the 9 digits are its RSIN; for a sole trader they are a separate number. Taken from the trade register extract when it shows one, otherwise built from the RSIN with subnumber B01. example: 813454554B01 description: Identifiers for Dutch companies (NL) NorwayIdentifiers: type: object properties: lei: type: string description: >- Legal Entity Identifier from GLEIF, returned when an existing company identifier uniquely matches a GLEIF registration or validation reference. Absent when no unambiguous identifier match is available. Lapsed and retired LEIs can be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 pattern: ^[A-Z0-9]{18}[0-9]{2}$ euid: type: string description: >- European Unique Identifier, derived for supported domestic company forms from the national register number. example: NOFOR.923609016 organisasjonsnummer: type: string description: >- Organisation Number (Organisasjonsnummer) - Company registration number. Format: 9 digits, no separators, starting with 8 or 9; the last digit is a modulus-11 check digit (e.g., "923609016"). Search also accepts it written with spaces or dots ("923 609 016", "923.609.016"). Issued by: Brønnøysund Register Centre. example: '923609016' VAT: type: string description: >- VAT number (MVA number) - the organisation number suffixed with "MVA". Format: 9 digits followed by "MVA", no separators (e.g., "923609016MVA"). Present only when the company is registered in the VAT register (Merverdiavgiftsregisteret). example: 923609016MVA description: Identifiers for Norwegian companies (NO) PolandIdentifiers: type: object properties: lei: type: string description: >- Legal Entity Identifier from GLEIF, returned when an existing company identifier uniquely matches a GLEIF registration or validation reference. Absent when no unambiguous identifier match is available. Lapsed and retired LEIs can be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 pattern: ^[A-Z0-9]{18}[0-9]{2}$ euid: type: string description: >- European Unique Identifier, derived for supported domestic company forms from the national register number. example: PLKRS.0000028860 krs: type: string description: >- KRS (Krajowy Rejestr Sądowy) - National Court Register number. Format: 10 digits, leading zeros significant (e.g., "0000028860"). Search results and company ids carry it with a krs- prefix (e.g., "krs-0000028860"). Issued by: National Court Register. example: '0000028860' nip: type: string description: >- NIP (Numer Identyfikacji Podatkowej) - Tax identification number. Format: 10 digits, the last one a check digit (e.g., "7740001454"). Sole entrepreneurs are returned by search with the id nip- + NIP. Issued by: Tax Office. example: '7740001454' regon: type: string description: >- REGON (Rejestr Gospodarki Narodowej) - Statistical number. Format: 9 digits for an entity or 14 digits for a local unit, the last one a check digit (e.g., "610188201"). Issued by: Central Statistical Office. example: '610188201' VAT: type: string description: >- VAT number (Numer Identyfikacji Podatkowej dla VAT) without PL prefix. In Poland, the VAT number equals the NIP. Format: 10 digits (same as NIP). example: '7740001454' description: Identifiers for Polish companies (PL) PortugalIdentifiers: type: object properties: lei: type: string description: >- Legal Entity Identifier from GLEIF, returned when an existing company identifier uniquely matches a GLEIF registration or validation reference. Absent when no unambiguous identifier match is available. Lapsed and retired LEIs can be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 pattern: ^[A-Z0-9]{18}[0-9]{2}$ euid: type: string description: >- European Unique Identifier, derived for supported domestic company forms: PTIRNMJ. followed by the 9-digit NIF. example: PTIRNMJ.517116022 NIF: type: string description: >- NIF (Número de Identificação Fiscal) - Tax identification number. Format: 9 digits, the last a mod-11 check digit. A legal person (NIPC) starts with 5, 6, 8 or 9, most companies with 5; a sole entrepreneur uses a personal NIF starting with 1 to 4. Issued by: the Registo Nacional de Pessoas Coletivas (RNPC) for a NIPC, the Autoridade Tributária e Aduaneira (Tax and Customs Authority) otherwise. example: '517116022' VAT: type: string description: >- VAT number (Número de Identificação de Valor Acrescentado) without PT prefix. In Portugal, the VAT number equals the NIF. Format: 9 digits (same as NIF). example: '517116022' description: Identifiers for Portuguese companies (PT) RomaniaIdentifiers: type: object properties: lei: type: string description: >- Legal Entity Identifier from GLEIF, returned when an existing company identifier uniquely matches a GLEIF registration or validation reference. Absent when no unambiguous identifier match is available. Lapsed and retired LEIs can be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 pattern: ^[A-Z0-9]{18}[0-9]{2}$ cui: type: string description: >- CUI (Cod Unic de Înregistrare) - fiscal identification code, never changed for the life of the company. Format: 2 to 10 digits (e.g., "37246510"). Search results carry the registration number as the company id, not the CUI. example: '37246510' registrationNumber: type: string description: >- Registration Number (Număr de ordine în Registrul Comerțului), the company id search returns. Format: either a letter + county code + sequence + year separated by slashes (e.g., "J40/8232/2024", "F16/655/2004"), or 14 characters: a letter + 4-digit year + 6-digit sequence + 2-digit county code (00 since 26 July 2024) + a check digit (e.g., "J2017003749401"). J legal entities, F authorised individuals and sole traders, C cooperatives. example: J2017003749401 VAT: type: string description: >- VAT number (Cod de TVA) without the RO prefix: the CUI, 2 to 10 digits. Returned only when VIES confirms the company is registered for VAT. example: '37246510' euid: type: string description: >- EUID (European Unique Identifier). Format: ROONRC. + the registration number in the form the register currently holds (e.g., "ROONRC.J2017003749401", "ROONRC.J40/8232/2024"). Issued by: National Trade Register Office (ONRC). example: ROONRC.J2017003749401 description: Identifiers for Romanian companies (RO) SerbiaIdentifiers: type: object properties: lei: type: string description: >- Legal Entity Identifier from GLEIF, returned when an existing company identifier uniquely matches a GLEIF registration or validation reference. Absent when no unambiguous identifier match is available. Lapsed and retired LEIs can be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 pattern: ^[A-Z0-9]{18}[0-9]{2}$ mbr: type: string description: >- MBR (Матични број / Matični broj registracije) - Company registration number. Format: 8 digits, leading zeros significant (e.g., "21837792", "07018835"). Issued by: APR (Agencija za privredne registre — Serbian Business Registers Agency). example: '21837792' taxNumber: type: string description: >- PIB (Порески идентификациони број) - Tax identification number. Format: 9 digits, the last a check digit (ISO 7064 MOD 11,10) (e.g., "113279163"). Issued by: Tax Administration of Serbia. example: '113279163' description: Identifiers for Serbian companies (RS) SwedenIdentifiers: type: object properties: lei: type: string description: >- Legal Entity Identifier from GLEIF, returned when an existing company identifier uniquely matches a GLEIF registration or validation reference. Absent when no unambiguous identifier match is available. Lapsed and retired LEIs can be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 pattern: ^[A-Z0-9]{18}[0-9]{2}$ euid: type: string description: >- European Unique Identifier, derived for supported domestic company forms from the national register number. example: SEBOLREG.5560360793 organizationNumber: type: string description: >- Organization Number (Organisationsnummer) - Company registration number. Format: 10 digits, returned without a separator (e.g., "5560360793"); also accepted as input with a hyphen after the sixth digit ("556036-0793"). The third digit is 2 or higher; the last digit is a Luhn check digit. Issued by: Swedish Companies Registration Office (Bolagsverket). example: '5560360793' VAT: type: string description: >- VAT number (Momsregistreringsnummer) without SE prefix. Format: 12 digits: the organisation number followed by "01" (e.g., "556036079301" from organisation number "5560360793"), or for a sole trader the personal identity number without its two century digits, followed by "01". example: '556036079301' personalIdentityNumber: type: string description: >- Personal Identity Number (Personnummer) — Used as the registration identifier for Swedish sole traders (enskild firma). Format: 12 digits YYYYMMDDNNNN, returned without a separator; also accepted as input hyphenated as YYYYMMDD-NNNN. Issued by Skatteverket; accepted by Bolagsverket as the business identifier for sole traders. example: '196405250314' description: Identifiers for Swedish companies (SE) SlovakiaIdentifiers: type: object properties: lei: type: string description: >- Legal Entity Identifier from GLEIF, returned when an existing company identifier uniquely matches a GLEIF registration or validation reference. Absent when no unambiguous identifier match is available. Lapsed and retired LEIs can be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 pattern: ^[A-Z0-9]{18}[0-9]{2}$ euid: type: string description: >- European Unique Identifier (EUID). Returned for eligible s.r.o. and a.s. companies confirmed in the Commercial Register. example: SKORSR.35763469 ico: type: string description: >- IČO (Identifikačné číslo organizácie) - Company identification number. Format: 8 digits, leading zeros significant; the eighth digit is a check digit (e.g., "35763469"). Issued by: Slovak Statistical Office. example: '35763469' description: Identifiers for Slovak companies (SK) SloveniaIdentifiers: type: object properties: lei: type: string description: >- Legal Entity Identifier from GLEIF, returned when an existing company identifier uniquely matches a GLEIF registration or validation reference. Absent when no unambiguous identifier match is available. Lapsed and retired LEIs can be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 pattern: ^[A-Z0-9]{18}[0-9]{2}$ euid: type: string description: >- European Unique Identifier (EUID). Returned for eligible d.o.o. and d.d. companies; sole traders and establishments are excluded. example: SIPRS.5025796000 registrationNumber: type: string description: >- Matična številka (Registration number). Format: 10 digits (e.g., "5025796000"): a 7-digit entity number ending in a check digit, then 000 for the entity itself or the sequence number of one of its branches. Issued by: AJPES (Slovenian Business Register). example: '5025796000' taxNumber: type: string description: >- Davčna številka (Tax number). Format: 8 digits (e.g., "80267432"). Issued by: Financial Administration of the Republic of Slovenia (FURS). example: '80267432' VAT: type: string description: >- VAT identification number. Format: SI + 8 digits (e.g., "SI80267432"). Issued by: Financial Administration of the Republic of Slovenia (FURS). example: SI80267432 description: Identifiers for Slovenian companies (SI) SpainIdentifiersDTO: type: object properties: lei: type: string description: >- Legal Entity Identifier from GLEIF, returned when an existing company identifier uniquely matches a GLEIF registration or validation reference. Absent when no unambiguous identifier match is available. Lapsed and retired LEIs can be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 pattern: ^[A-Z0-9]{18}[0-9]{2}$ nif: type: string description: >- NIF/CIF (Número de Identificación Fiscal). A legal entity's NIF is 9 characters: a letter for the legal form, 7 digits, then a check character that is a digit or a letter (e.g. "A82511361"). A natural person's NIF (DNI) is 8 digits followed by a check letter (e.g. "12345678Z"). Returned as the register records it, which in rare records means a NIF with a character missing (e.g. "A5859731"). example: A82511361 VAT: type: string description: VAT number (IVA) without ES prefix. In Spain, this equals the NIF. example: A82511361 euid: type: string description: >- EUID (European Unique Identifier) — the cross-EU company identifier from the Business Registers Interconnection System (BRIS). Returned when published in the open data extract. example: ES28.RM-M28038019301 hoja: type: string description: >- Hoja registral: the Mercantile Register sheet reference (a province code of 1 or 2 letters, a hyphen, then the sheet number, e.g. M-213521 or BI-65606). This is the value LEI/GLEIF records publish as the Spanish "Registration Authority Entity ID" (there with a trailing control digit). Returned when the company is matched in the BORME gazette. example: M-213521 NIF: type: string deprecated: true description: >- Deprecated legacy alias of `nif` — use `nif`. Emitted until 2026-09-01. example: A82511361 UnitedKingdomIdentifiers: type: object properties: lei: type: string description: >- Legal Entity Identifier from GLEIF, returned when an existing company identifier uniquely matches a GLEIF registration or validation reference. Absent when no unambiguous identifier match is available. Lapsed and retired LEIs can be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 pattern: ^[A-Z0-9]{18}[0-9]{2}$ companiesHouseNumber: type: string description: >- Companies House Number - the company registration number issued by Companies House. Format: always 8 characters, uppercase letters and digits, leading zeros significant: 8 digits (e.g. "00445790"), a 2-letter prefix and 6 digits (e.g. "SC132832", "OC303675", "FC027926"), or occasionally another arrangement of letters (e.g. "R0000390", "IP03289R"). This is the single canonical UK company-number key: it is used for the queried company and for every related company (officers, persons with significant control, and reconstructed shareholders). example: '00445790' description: Identifiers for UK companies (GB) BVIIdentifiers: type: object properties: lei: type: string description: >- Legal Entity Identifier from GLEIF, returned when an existing company identifier uniquely matches a GLEIF registration or validation reference. Absent when no unambiguous identifier match is available. Lapsed and retired LEIs can be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 pattern: ^[A-Z0-9]{18}[0-9]{2}$ companyNumber: type: string description: >- Company Number - registration number issued by the BVI Financial Services Commission. Format: digits only, no leading zeros (5 to 7 digits in the records we have seen, e.g. "587145", "1567724"); older local companies carry an "L" prefix (e.g. "L658"). example: '587145' description: Identifiers for BVI companies (VG) BosniaIdentifiers: type: object properties: lei: type: string description: >- Legal Entity Identifier from GLEIF, returned when an existing company identifier uniquely matches a GLEIF registration or validation reference. Absent when no unambiguous identifier match is available. Lapsed and retired LEIs can be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 pattern: ^[A-Z0-9]{18}[0-9]{2}$ mbs: type: string description: >- MBS (Matični broj subjekta) - Court register number, exactly as the register publishes it. Format: hyphen-separated digit groups: `NN-0C-XXXX-YY` (e.g. "65-01-0620-08"), two groups (e.g. "1-369", "1-12440"), three groups ending in -00 (e.g. "3-35-00"), or, on a few older Republika Srpska records, `RU-` + three groups (e.g. "RU-1-1852-00"). Issued by: the registration court. NOT nationally unique: each of the three BiH registers numbers independently, so the same MBS can identify different companies in different registers. Use `company.id`, which is register-qualified ("FBiH 65-01-0620-08", "Brčko 1-369", "RS 3-35-00 4402503100008"), when you need a unique key. example: 65-01-0620-08 jib: type: string description: >- JIB / IDU (Jedinstveni identifikacijski broj) - Unique identification number. Format: 13 digits (e.g., "4402503100008"). Issued by: UINO (Indirect Taxation Authority of BiH), at state level. Nationally unique and stable across register moves, which makes it the reliable key for cross-referencing an entity between the three registers. example: '4402503100008' description: Identifiers for Bosnian companies (BA) BulgariaIdentifiers: type: object properties: lei: type: string description: >- Legal Entity Identifier from GLEIF, returned when an existing company identifier uniquely matches a GLEIF registration or validation reference. Absent when no unambiguous identifier match is available. Lapsed and retired LEIs can be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 pattern: ^[A-Z0-9]{18}[0-9]{2}$ euid: type: string description: >- European Unique Identifier (EUID). Returned for eligible OOD, EOOD, AD and EAD companies in the Commercial Register. example: BGCOMREG.831094393 uic: type: string description: >- EIK / UIC (Единен идентификационен код) - the Bulgarian company registration number. Format: 9 digits for a company (e.g., "208582266"); 13 digits for a branch (e.g., "0006940370018"). Issued by: Registry Agency (Агенция по вписванията). Also serves as the national tax identifier. example: '208582266' VAT: type: string description: >- VAT number without the BG prefix. Format: 9 digits, identical to the UIC. Returned when the entity is registered for VAT and the number is validated against VIES. example: '208582266' description: Identifiers for Bulgarian companies (BG) GreeceIdentifiers: type: object properties: lei: type: string description: >- Legal Entity Identifier from GLEIF, returned when an existing company identifier uniquely matches a GLEIF registration or validation reference. Absent when no unambiguous identifier match is available. Lapsed and retired LEIs can be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 pattern: ^[A-Z0-9]{18}[0-9]{2}$ euid: type: string description: >- European Unique Identifier derived from the confirmed GEMI identity for supported domestic AE and IKE companies. example: ELGEMI.000031301000 gemiNumber: type: string description: >- Αριθμός ΓΕΜΗ - GEMI number. Format: up to 12 digits, returned without leading zeros (e.g., "31301000", "101933403000"); the full 12-digit form with leading zeros is the same number. Issued by: General Commercial Register (ΓΕΜΗ / GEMI). example: '31301000' vatNumber: type: string description: >- VAT number (ΑΦΜ / AFM) with the EL prefix. Format: EL followed by 9 digits, leading zeros significant, the last digit a check digit (e.g., "EL093808863"). example: EL093808863 taxNumber: type: string description: >- Tax registration number (ΑΦΜ / AFM) without the EL prefix. Format: 9 digits, leading zeros significant, the last digit a check digit (e.g., "093808863"). example: '093808863' description: Identifiers for Greek companies (GR) LithuaniaIdentifiers: type: object properties: lei: type: string description: >- Legal Entity Identifier from GLEIF, returned when an existing company identifier uniquely matches a GLEIF registration or validation reference. Absent when no unambiguous identifier match is available. Lapsed and retired LEIs can be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 pattern: ^[A-Z0-9]{18}[0-9]{2}$ euid: type: string description: >- European Unique Identifier (EUID). Returned for UAB and AB companies with a register-confirmed legal-entity code and legal form. example: LTJAR.123033512 jaKodas: type: string description: >- Juridinio asmens kodas (legal-entity code) - the registration number assigned by the Register of Legal Entities. Format: 9 digits (e.g., "123033512"). Issued by: Registrų centras (State Enterprise Centre of Registers). example: '123033512' description: Identifiers for Lithuanian companies (LT) MoldovaIdentifiers: type: object properties: lei: type: string description: >- Legal Entity Identifier from GLEIF, returned when an existing company identifier uniquely matches a GLEIF registration or validation reference. Absent when no unambiguous identifier match is available. Lapsed and retired LEIs can be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 pattern: ^[A-Z0-9]{18}[0-9]{2}$ idno: type: string description: >- IDNO - Numărul de identificare de stat (state identification number). Format: 13 digits (e.g., "1003603151655"), the last a check digit (first 12 digits weighted 7, 3, 1 repeating, sum modulo 10). A few old records in the open data carry a shorter number (e.g., "10013"). Issued by: Public Services Agency (Agenția Servicii Publice). example: '1003603151655' md_synthetic: type: string description: >- Synthetic fallback identifier assigned by Topograph when an entity in the register's open data has no published IDNO. Format: md_noidno_ + 12 lowercase hexadecimal characters (e.g., "md_noidno_e251fab5710b"). Used in place of "idno" for those records, and is also their company id. example: md_noidno_e251fab5710b description: Identifiers for Moldovan companies (MD) RussiaIdentifiers: type: object properties: lei: type: string description: >- Legal Entity Identifier from GLEIF, returned when an existing company identifier uniquely matches a GLEIF registration or validation reference. Absent when no unambiguous identifier match is available. Lapsed and retired LEIs can be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 pattern: ^[A-Z0-9]{18}[0-9]{2}$ ogrn: type: string description: >- OGRN - Primary State Registration Number for legal entities. Format: 13 digits starting with 1 or 5, the last one a check digit (e.g., "1027700035769"). Issued by: Federal Tax Service (EGRUL). example: '1027700035769' ogrnip: type: string description: >- OGRNIP - Primary State Registration Number for individual entrepreneurs. Format: 15 digits starting with 3, the last one a check digit (e.g., "318028000064743"). Issued by: Federal Tax Service (EGRIP). example: '318028000064743' inn: type: string description: >- INN - Taxpayer Identification Number. Format: 10 digits for legal entities (the last one a check digit, e.g., "7708004767"), 12 digits for sole entrepreneurs and individuals (the last two check digits). Leading zeros are significant. Issued by: Federal Tax Service. example: '7708004767' kpp: type: string description: >- KPP - Tax Registration Reason Code (subdivision assignment code). Format: 9 characters, usually all digits (e.g., "770801001"); the 5th and 6th may be uppercase Latin letters. Assigned per registration with the tax authority. Not applicable to sole entrepreneurs. example: '770801001' description: Identifiers for Russian companies (RU) SingaporeIdentifiers: type: object properties: lei: type: string description: >- Legal Entity Identifier from GLEIF, returned when an existing company identifier uniquely matches a GLEIF registration or validation reference. Absent when no unambiguous identifier match is available. Lapsed and retired LEIs can be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 pattern: ^[A-Z0-9]{18}[0-9]{2}$ uen: type: string description: >- UEN - Unique Entity Number. Format: 9 or 10 characters ending in a check letter: 8 digits + letter for businesses (e.g., "52898560D"), year + 5 digits + letter for local companies (e.g., "201932822G"), or T/S/R + 2-digit year + 2-character entity type + 4 digits + letter for other entities (e.g., "T17LL0584B"). Issued by: ACRA (Accounting and Corporate Regulatory Authority). example: 201932822G description: Identifiers for Singapore companies (SG) UkraineIdentifiers: type: object properties: lei: type: string description: >- Legal Entity Identifier from GLEIF, returned when an existing company identifier uniquely matches a GLEIF registration or validation reference. Absent when no unambiguous identifier match is available. Lapsed and retired LEIs can be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 pattern: ^[A-Z0-9]{18}[0-9]{2}$ edrpou: type: string description: >- EDRPOU code - the registration code for legal entities and foreign subdivisions. Format: 8 digits, leading zeros significant, the last one a check digit (e.g., "00113968"). Issued by: EDR (Unified State Register of Ukraine). example: '00113968' record: type: string description: >- Record number - the EDR open-data record number for sole entrepreneurs (FOP). Format: digits only, 7 or 8 in the records we have seen (e.g., "10693269"). The company id is this number with a FOP- prefix (e.g., "FOP-10693269"). example: '10693269' description: Identifiers for Ukrainian companies (UA) CaymanIdentifiers: type: object properties: lei: type: string description: >- Legal Entity Identifier from GLEIF, returned when an existing company identifier uniquely matches a GLEIF registration or validation reference. Absent when no unambiguous identifier match is available. Lapsed and retired LEIs can be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 pattern: ^[A-Z0-9]{18}[0-9]{2}$ registrationNumber: type: string description: >- Company Registration Number issued by the Cayman Islands General Registry (Registrar of Companies), as printed on the Search Report and the Certificate of Incorporation: usually digits (e.g. "320834"), sometimes quoted with a two-letter prefix (e.g. "CR-72229"). Not usable as a query: company.id and search results carry the entity name encoded in base64 instead. example: '320834' description: Identifiers for Cayman Islands companies (KY) MarshallIslandsIdentifiers: type: object properties: lei: type: string description: >- Legal Entity Identifier from GLEIF, returned when an existing company identifier uniquely matches a GLEIF registration or validation reference. Absent when no unambiguous identifier match is available. Lapsed and retired LEIs can be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 pattern: ^[A-Z0-9]{18}[0-9]{2}$ entityNumber: type: string description: >- Entity Number assigned by the Republic of the Marshall Islands corporate register (operated by International Registries, Inc.). Digits only, no leading zeros (4 to 6 digits in the records we have seen, e.g. "35087", "127599"). Shown on the register entity-search detail page and the Non-Resident Entity Report. example: '127599' description: Identifiers for Marshall Islands entities (MH) CanadaFederalIdentifiers: type: object properties: lei: type: string description: >- Legal Entity Identifier from GLEIF, returned when an existing company identifier uniquely matches a GLEIF registration or validation reference. Absent when no unambiguous identifier match is available. Lapsed and retired LEIs can be returned; annulled LEIs are excluded. example: 96950066U5XAAIRCPA78 pattern: ^[A-Z0-9]{18}[0-9]{2}$ corporationNumber: type: string description: >- Corporation number assigned by Corporations Canada. Format: digits only, no leading zero, 4 to 8 digits in the records we have seen (e.g. "8660115", "15544106"). The register displays it with a hyphen before the last digit ("866011-5"); /v2/company accepts both forms. example: '8660115' businessNumber: type: string description: >- Business Number (BN), the 9-digit federal business identifier issued by the Canada Revenue Agency (e.g. "835752437"). Searchable with /v2/search, which resolves it to the corporation number. A Business Number can be shared by several corporations (an amalgamated corporation keeps one of its predecessors' numbers), so it is not a /v2/company identifier. example: '835752437' description: >- Identifiers for Canadian federal corporations (CA-FED), kept by Corporations Canada securitySchemes: x-api-key: type: apiKey in: header name: x-api-key ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.