{ "x402Version": 2, "id": 35043, "slug": "35043", "resource": "https://api.17711.xyz/registry/company-check-service/v1/company-check/verify_company", "description": "Company check (KYB): registry status, VAT number validation (VIES), LEI and directors of a company by name, SIREN or VAT number", "type": "http", "serviceName": "17711 Company Registry Check", "accepts": [ { "scheme": "exact", "network": "eip155:8453", "payTo": "0x19824cf672f28fa63024731ebc7405aa3733e0ba", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "amount": "9000", "amountUsd": 0.009, "maxTimeoutSeconds": 120 } ], "outputSchema": { "properties": { "example": { "properties": { "age_seconds": { "description": "How old this answer is, in seconds (0 for a fresh check).", "format": "uint64", "minimum": 0, "type": "integer" }, "company": { "$ref": "#/$defs/Company" }, "confidence": { "description": "`high` (identified by a number), `medium` (a clear name match) or `low` (several similar names).", "type": "string" }, "coverage_note": { "description": "What this answer does not cover for the company's country.", "type": "string" }, "directors": { "description": "Officers and statutory auditors published in the register (France only).", "items": { "$ref": "#/$defs/Director" }, "type": "array" }, "financials": { "description": "Revenue and net result of the latest published years (France only).", "items": { "$ref": "#/$defs/Financial" }, "type": "array" }, "flags": { "description": "Things to know: closed company, invalid VAT number, name mismatch, lapsed LEI.", "items": { "$ref": "#/$defs/Flag" }, "type": "array" }, "from_cache": { "description": "`true` when this answer was served from a stored result.", "type": "boolean" }, "lei": { "anyOf": [ { "$ref": "#/$defs/LeiRecord" }, { "type": "null" } ] }, "matched_by": { "description": "How the company was identified: `lei`, `vat_number`, `registration_number` or `name`.", "type": "string" }, "other_candidates": { "description": "Other companies that matched a name search (to disambiguate).", "items": { "$ref": "#/$defs/Candidate" }, "type": "array" }, "retrieved_at": { "description": "When the registers were queried (UTC).", "type": "string" }, "sources": { "description": "The registers consulted.", "items": { "type": "string" }, "type": "array" }, "vat": { "anyOf": [ { "$ref": "#/$defs/VatCheck" }, { "type": "null" } ], "description": "VAT number validation, when a VAT number is known." } }, "required": [ "matched_by", "confidence", "company", "directors", "financials", "other_candidates", "flags", "sources", "coverage_note", "retrieved_at", "age_seconds", "from_cache" ], "title": "VerifyCompanyResponse", "type": "object" }, "type": { "const": "json" } }, "required": [ "type" ], "type": "object" }, "extensions": { "bazaar": { "info": { "input": { "body": { "company_name": "string", "country": "string", "lei": "string", "max_age_seconds": 0, "registration_number": "string", "vat_number": "string" }, "bodyType": "json", "method": "POST", "type": "http" }, "output": { "example": { "age_seconds": 0, "company": { "activity_code": "string", "address": "string", "closed_at": "string", "country": "string", "created_at": "string", "employees": "string", "head_office_id": "string", "legal_form": "string", "legal_name": "string", "lei": "string", "registration_number": "string", "size_category": "string", "status": "string", "trade_name": "string", "vat_number": "string" }, "confidence": "string", "coverage_note": "string", "directors": [ { "born": "string", "kind": "string", "name": "string", "nationality": "string", "registration_number": "string", "role": "string" } ], "financials": [ { "net_result": 0, "revenue": 0, "year": 0 } ], "flags": [ { "code": "string", "message": "string", "severity": "string" } ], "from_cache": false, "lei": { "direct_parent": { "country": "string", "legal_name": "string", "lei": "string" }, "entity_status": "string", "lei": "string", "next_renewal": "string", "registration_status": "string", "ultimate_parent": { "country": "string", "legal_name": "string", "lei": "string" } }, "matched_by": "string", "other_candidates": [ { "city": "string", "name": "string", "registration_number": "string", "status": "string" } ], "retrieved_at": "string", "sources": [ "string" ], "vat": { "checked_at": "string", "number": "string", "registered_address": "string", "registered_name": "string", "status": "string" } }, "type": "json" } }, "schema": { "$defs": { "Candidate": { "properties": { "city": { "type": [ "string", "null" ] }, "name": { "type": "string" }, "registration_number": { "type": "string" }, "status": { "type": "string" } }, "required": [ "name", "registration_number", "status" ], "type": "object" }, "Company": { "properties": { "activity_code": { "description": "Main activity code (NAF/APE for France).", "type": [ "string", "null" ] }, "address": { "type": [ "string", "null" ] }, "closed_at": { "description": "Date of closure (YYYY-MM-DD), when closed.", "type": [ "string", "null" ] }, "country": { "description": "ISO country code of the legal seat.", "type": "string" }, "created_at": { "description": "Date of creation (YYYY-MM-DD).", "type": [ "string", "null" ] }, "employees": { "description": "Employee size bracket, e.g. `50-99`.", "type": [ "string", "null" ] }, "head_office_id": { "description": "SIRET of the head office (France).", "type": [ "string", "null" ] }, "legal_form": { "description": "Legal form (`SAS`, `SARL`, ...) or its register code.", "type": [ "string", "null" ] }, "legal_name": { "type": "string" }, "lei": { "type": [ "string", "null" ] }, "registration_number": { "description": "Number in the company register (SIREN for France).", "type": [ "string", "null" ] }, "size_category": { "description": "Size category: `PME`, `ETI`, `GE`.", "type": [ "string", "null" ] }, "status": { "description": "`active`, `closed` or `unknown`.", "type": "string" }, "trade_name": { "description": "Commercial name or acronym, when different.", "type": [ "string", "null" ] }, "vat_number": { "type": [ "string", "null" ] } }, "required": [ "legal_name", "status", "country" ], "type": "object" }, "Director": { "properties": { "born": { "description": "Month and year of birth (`1975-01`) for a person, as published in the register.", "type": [ "string", "null" ] }, "kind": { "description": "`person` or `company`.", "type": "string" }, "name": { "description": "Full name of the person or the legal entity.", "type": "string" }, "nationality": { "type": [ "string", "null" ] }, "registration_number": { "description": "Registration number of a legal-entity director.", "type": [ "string", "null" ] }, "role": { "description": "Role as published (`Président de SAS`, `Directeur Général`, `Commissaire aux comptes titulaire`...).", "type": "string" } }, "required": [ "name", "role", "kind" ], "type": "object" }, "Financial": { "properties": { "net_result": { "description": "Net result, in euros.", "format": "int64", "type": [ "integer", "null" ] }, "revenue": { "description": "Revenue, in euros.", "format": "int64", "type": [ "integer", "null" ] }, "year": { "format": "uint32", "minimum": 0, "type": "integer" } }, "required": [ "year" ], "type": "object" }, "Flag": { "properties": { "code": { "description": "Stable code, e.g. `company.closed`, `vat.invalid`, `vat.name_mismatch`, `lei.lapsed`.", "type": "string" }, "message": { "type": "string" }, "severity": { "description": "`high`, `medium`, `low` or `info`.", "type": "string" } }, "required": [ "severity", "code", "message" ], "type": "object" }, "LeiParent": { "properties": { "country": { "type": [ "string", "null" ] }, "legal_name": { "type": "string" }, "lei": { "type": "string" } }, "required": [ "lei", "legal_name" ], "type": "object" }, "LeiRecord": { "properties": { "direct_parent": { "anyOf": [ { "$ref": "#/$defs/LeiParent" }, { "type": "null" } ] }, "entity_status": { "description": "Entity status in the LEI register (`ACTIVE`, `INACTIVE`).", "type": "string" }, "lei": { "type": "string" }, "next_renewal": { "type": [ "string", "null" ] }, "registration_status": { "description": "Registration status of the LEI (`ISSUED`, `LAPSED`, ...).", "type": "string" }, "ultimate_parent": { "anyOf": [ { "$ref": "#/$defs/LeiParent" }, { "type": "null" } ] } }, "required": [ "lei", "entity_status", "registration_status" ], "type": "object" }, "VatCheck": { "properties": { "checked_at": { "description": "When the number was validated (UTC).", "type": "string" }, "number": { "description": "The number as checked, with country prefix.", "type": "string" }, "registered_address": { "type": [ "string", "null" ] }, "registered_name": { "description": "Name registered for the VAT number, when the member state discloses it.", "type": [ "string", "null" ] }, "status": { "description": "`valid`, `invalid` or `unavailable` (the EU service did not answer: try again later).", "type": "string" } }, "required": [ "number", "status", "checked_at" ], "type": "object" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "input": { "properties": { "body": { "properties": { "company_name": { "default": null, "description": "The company's name (`OVH`, `Mistral AI`). Give at least one of `company_name`,\n`registration_number`, `vat_number` or `lei`.", "type": [ "string", "null" ] }, "country": { "default": null, "description": "ISO 3166-1 alpha-2 country code (`FR`, `DE`) to narrow a name or number search.", "type": [ "string", "null" ] }, "lei": { "default": null, "description": "A Legal Entity Identifier (20 characters).", "type": [ "string", "null" ] }, "max_age_seconds": { "default": null, "description": "The oldest answer you accept, in seconds. Omit it for the default (answers up to 6 hours\nold); `0` forces a fresh check, including a new VAT validation.", "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "registration_number": { "default": null, "description": "A company registration number: a French SIREN (9 digits) or SIRET (14 digits), or a number\nfrom another register (then give `country`).", "type": [ "string", "null" ] }, "vat_number": { "default": null, "description": "An EU VAT number with its country prefix (`FR22424761419`, `DE811907980`).", "type": [ "string", "null" ] } }, "title": "VerifyCompanyRequest", "type": "object" }, "bodyType": { "const": "json" }, "method": { "const": "POST" }, "type": { "const": "http" } }, "required": [ "type", "method", "bodyType", "body" ], "type": "object" }, "output": { "properties": { "example": { "properties": { "age_seconds": { "description": "How old this answer is, in seconds (0 for a fresh check).", "format": "uint64", "minimum": 0, "type": "integer" }, "company": { "$ref": "#/$defs/Company" }, "confidence": { "description": "`high` (identified by a number), `medium` (a clear name match) or `low` (several similar names).", "type": "string" }, "coverage_note": { "description": "What this answer does not cover for the company's country.", "type": "string" }, "directors": { "description": "Officers and statutory auditors published in the register (France only).", "items": { "$ref": "#/$defs/Director" }, "type": "array" }, "financials": { "description": "Revenue and net result of the latest published years (France only).", "items": { "$ref": "#/$defs/Financial" }, "type": "array" }, "flags": { "description": "Things to know: closed company, invalid VAT number, name mismatch, lapsed LEI.", "items": { "$ref": "#/$defs/Flag" }, "type": "array" }, "from_cache": { "description": "`true` when this answer was served from a stored result.", "type": "boolean" }, "lei": { "anyOf": [ { "$ref": "#/$defs/LeiRecord" }, { "type": "null" } ] }, "matched_by": { "description": "How the company was identified: `lei`, `vat_number`, `registration_number` or `name`.", "type": "string" }, "other_candidates": { "description": "Other companies that matched a name search (to disambiguate).", "items": { "$ref": "#/$defs/Candidate" }, "type": "array" }, "retrieved_at": { "description": "When the registers were queried (UTC).", "type": "string" }, "sources": { "description": "The registers consulted.", "items": { "type": "string" }, "type": "array" }, "vat": { "anyOf": [ { "$ref": "#/$defs/VatCheck" }, { "type": "null" } ], "description": "VAT number validation, when a VAT number is known." } }, "required": [ "matched_by", "confidence", "company", "directors", "financials", "other_candidates", "flags", "sources", "coverage_note", "retrieved_at", "age_seconds", "from_cache" ], "title": "VerifyCompanyResponse", "type": "object" }, "type": { "const": "json" } }, "required": [ "type" ], "type": "object" } }, "required": [ "input" ], "type": "object" } } }, "tags": [ "company-check", "kyb", "vat-validation", "company-directors", "lei-lookup", "bazaar" ], "sourceHost": "api.17711.xyz", "lastUpdated": "2026-10-12T15:49:38.127Z", "quality": { "calls30d": 1, "uniquePayers30d": 1, "lastCalledAt": "2026-10-12T15:49:37.591Z" }, "metadata": { "serviceName": "17711 Company Registry Check", "extensions": { "bazaar": { "info": { "input": { "body": { "company_name": "string", "country": "string", "lei": "string", "max_age_seconds": 0, "registration_number": "string", "vat_number": "string" }, "bodyType": "json", "method": "POST", "type": "http" }, "output": { "example": { "age_seconds": 0, "company": { "activity_code": "string", "address": "string", "closed_at": "string", "country": "string", "created_at": "string", "employees": "string", "head_office_id": "string", "legal_form": "string", "legal_name": "string", "lei": "string", "registration_number": "string", "size_category": "string", "status": "string", "trade_name": "string", "vat_number": "string" }, "confidence": "string", "coverage_note": "string", "directors": [ { "born": "string", "kind": "string", "name": "string", "nationality": "string", "registration_number": "string", "role": "string" } ], "financials": [ { "net_result": 0, "revenue": 0, "year": 0 } ], "flags": [ { "code": "string", "message": "string", "severity": "string" } ], "from_cache": false, "lei": { "direct_parent": { "country": "string", "legal_name": "string", "lei": "string" }, "entity_status": "string", "lei": "string", "next_renewal": "string", "registration_status": "string", "ultimate_parent": { "country": "string", "legal_name": "string", "lei": "string" } }, "matched_by": "string", "other_candidates": [ { "city": "string", "name": "string", "registration_number": "string", "status": "string" } ], "retrieved_at": "string", "sources": [ "string" ], "vat": { "checked_at": "string", "number": "string", "registered_address": "string", "registered_name": "string", "status": "string" } }, "type": "json" } }, "schema": { "$defs": { "Candidate": { "properties": { "city": { "type": [ "string", "null" ] }, "name": { "type": "string" }, "registration_number": { "type": "string" }, "status": { "type": "string" } }, "required": [ "name", "registration_number", "status" ], "type": "object" }, "Company": { "properties": { "activity_code": { "description": "Main activity code (NAF/APE for France).", "type": [ "string", "null" ] }, "address": { "type": [ "string", "null" ] }, "closed_at": { "description": "Date of closure (YYYY-MM-DD), when closed.", "type": [ "string", "null" ] }, "country": { "description": "ISO country code of the legal seat.", "type": "string" }, "created_at": { "description": "Date of creation (YYYY-MM-DD).", "type": [ "string", "null" ] }, "employees": { "description": "Employee size bracket, e.g. `50-99`.", "type": [ "string", "null" ] }, "head_office_id": { "description": "SIRET of the head office (France).", "type": [ "string", "null" ] }, "legal_form": { "description": "Legal form (`SAS`, `SARL`, ...) or its register code.", "type": [ "string", "null" ] }, "legal_name": { "type": "string" }, "lei": { "type": [ "string", "null" ] }, "registration_number": { "description": "Number in the company register (SIREN for France).", "type": [ "string", "null" ] }, "size_category": { "description": "Size category: `PME`, `ETI`, `GE`.", "type": [ "string", "null" ] }, "status": { "description": "`active`, `closed` or `unknown`.", "type": "string" }, "trade_name": { "description": "Commercial name or acronym, when different.", "type": [ "string", "null" ] }, "vat_number": { "type": [ "string", "null" ] } }, "required": [ "legal_name", "status", "country" ], "type": "object" }, "Director": { "properties": { "born": { "description": "Month and year of birth (`1975-01`) for a person, as published in the register.", "type": [ "string", "null" ] }, "kind": { "description": "`person` or `company`.", "type": "string" }, "name": { "description": "Full name of the person or the legal entity.", "type": "string" }, "nationality": { "type": [ "string", "null" ] }, "registration_number": { "description": "Registration number of a legal-entity director.", "type": [ "string", "null" ] }, "role": { "description": "Role as published (`Président de SAS`, `Directeur Général`, `Commissaire aux comptes titulaire`...).", "type": "string" } }, "required": [ "name", "role", "kind" ], "type": "object" }, "Financial": { "properties": { "net_result": { "description": "Net result, in euros.", "format": "int64", "type": [ "integer", "null" ] }, "revenue": { "description": "Revenue, in euros.", "format": "int64", "type": [ "integer", "null" ] }, "year": { "format": "uint32", "minimum": 0, "type": "integer" } }, "required": [ "year" ], "type": "object" }, "Flag": { "properties": { "code": { "description": "Stable code, e.g. `company.closed`, `vat.invalid`, `vat.name_mismatch`, `lei.lapsed`.", "type": "string" }, "message": { "type": "string" }, "severity": { "description": "`high`, `medium`, `low` or `info`.", "type": "string" } }, "required": [ "severity", "code", "message" ], "type": "object" }, "LeiParent": { "properties": { "country": { "type": [ "string", "null" ] }, "legal_name": { "type": "string" }, "lei": { "type": "string" } }, "required": [ "lei", "legal_name" ], "type": "object" }, "LeiRecord": { "properties": { "direct_parent": { "anyOf": [ { "$ref": "#/$defs/LeiParent" }, { "type": "null" } ] }, "entity_status": { "description": "Entity status in the LEI register (`ACTIVE`, `INACTIVE`).", "type": "string" }, "lei": { "type": "string" }, "next_renewal": { "type": [ "string", "null" ] }, "registration_status": { "description": "Registration status of the LEI (`ISSUED`, `LAPSED`, ...).", "type": "string" }, "ultimate_parent": { "anyOf": [ { "$ref": "#/$defs/LeiParent" }, { "type": "null" } ] } }, "required": [ "lei", "entity_status", "registration_status" ], "type": "object" }, "VatCheck": { "properties": { "checked_at": { "description": "When the number was validated (UTC).", "type": "string" }, "number": { "description": "The number as checked, with country prefix.", "type": "string" }, "registered_address": { "type": [ "string", "null" ] }, "registered_name": { "description": "Name registered for the VAT number, when the member state discloses it.", "type": [ "string", "null" ] }, "status": { "description": "`valid`, `invalid` or `unavailable` (the EU service did not answer: try again later).", "type": "string" } }, "required": [ "number", "status", "checked_at" ], "type": "object" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "input": { "properties": { "body": { "properties": { "company_name": { "default": null, "description": "The company's name (`OVH`, `Mistral AI`). Give at least one of `company_name`,\n`registration_number`, `vat_number` or `lei`.", "type": [ "string", "null" ] }, "country": { "default": null, "description": "ISO 3166-1 alpha-2 country code (`FR`, `DE`) to narrow a name or number search.", "type": [ "string", "null" ] }, "lei": { "default": null, "description": "A Legal Entity Identifier (20 characters).", "type": [ "string", "null" ] }, "max_age_seconds": { "default": null, "description": "The oldest answer you accept, in seconds. Omit it for the default (answers up to 6 hours\nold); `0` forces a fresh check, including a new VAT validation.", "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "registration_number": { "default": null, "description": "A company registration number: a French SIREN (9 digits) or SIRET (14 digits), or a number\nfrom another register (then give `country`).", "type": [ "string", "null" ] }, "vat_number": { "default": null, "description": "An EU VAT number with its country prefix (`FR22424761419`, `DE811907980`).", "type": [ "string", "null" ] } }, "title": "VerifyCompanyRequest", "type": "object" }, "bodyType": { "const": "json" }, "method": { "const": "POST" }, "type": { "const": "http" } }, "required": [ "type", "method", "bodyType", "body" ], "type": "object" }, "output": { "properties": { "example": { "properties": { "age_seconds": { "description": "How old this answer is, in seconds (0 for a fresh check).", "format": "uint64", "minimum": 0, "type": "integer" }, "company": { "$ref": "#/$defs/Company" }, "confidence": { "description": "`high` (identified by a number), `medium` (a clear name match) or `low` (several similar names).", "type": "string" }, "coverage_note": { "description": "What this answer does not cover for the company's country.", "type": "string" }, "directors": { "description": "Officers and statutory auditors published in the register (France only).", "items": { "$ref": "#/$defs/Director" }, "type": "array" }, "financials": { "description": "Revenue and net result of the latest published years (France only).", "items": { "$ref": "#/$defs/Financial" }, "type": "array" }, "flags": { "description": "Things to know: closed company, invalid VAT number, name mismatch, lapsed LEI.", "items": { "$ref": "#/$defs/Flag" }, "type": "array" }, "from_cache": { "description": "`true` when this answer was served from a stored result.", "type": "boolean" }, "lei": { "anyOf": [ { "$ref": "#/$defs/LeiRecord" }, { "type": "null" } ] }, "matched_by": { "description": "How the company was identified: `lei`, `vat_number`, `registration_number` or `name`.", "type": "string" }, "other_candidates": { "description": "Other companies that matched a name search (to disambiguate).", "items": { "$ref": "#/$defs/Candidate" }, "type": "array" }, "retrieved_at": { "description": "When the registers were queried (UTC).", "type": "string" }, "sources": { "description": "The registers consulted.", "items": { "type": "string" }, "type": "array" }, "vat": { "anyOf": [ { "$ref": "#/$defs/VatCheck" }, { "type": "null" } ], "description": "VAT number validation, when a VAT number is known." } }, "required": [ "matched_by", "confidence", "company", "directors", "financials", "other_candidates", "flags", "sources", "coverage_note", "retrieved_at", "age_seconds", "from_cache" ], "title": "VerifyCompanyResponse", "type": "object" }, "type": { "const": "json" } }, "required": [ "type" ], "type": "object" } }, "required": [ "input" ], "type": "object" } } } }, "liveness": { "reliability": null }, "verified": false, "featured": false, "provider": { "host": "api.17711.xyz", "manifest_name": "api.17711.xyz", "source": "cdp-mirror", "source_manifest_url": "https://api.cdp.coinbase.com/platform/v2/x402/discovery/resources", "submitted_at": "2026-10-13T15:56:53.641Z" }, "exampleResponse": { "example": { "age_seconds": 0, "company": null, "confidence": "string", "coverage_note": "string", "directors": [ "value" ], "financials": [ "value" ], "flags": [ "value" ], "from_cache": true, "lei": null, "matched_by": "string", "other_candidates": [ "value" ], "retrieved_at": "string", "sources": [ "string" ], "vat": null }, "type": null } }