17711 Company Registry Check
Company check (KYB): registry status, VAT number validation (VIES), LEI and directors of a company by name, SIREN or VAT number
Offering
- Provider
- api.17711.xyz
- Method
- POST
- Offering type
- Api Endpoint
- Transport type
- http
- Category
- Legal And Compliance
- Delivery
- Not provided
- Pricing model
- Not provided
- x402 version
- 2
Endpoint context
- URL
https://api.17711.xyz/registry/company-check-service/v1/company-check/verify_company- MIME type
- Not provided
- First seen
- 2026-10-16T01:50:32.458Z
- Last seen
- Tags
- company-check, KYB, vat-validation, company-directors, lei-lookup
Payment pricing
x402 payment terms are the authoritative price for calling this endpoint.
- Payment option 1
- 0.009 USDC
Atomic price: 9000 · Network: eip155:8453 · Asset: USDC · Scheme: exact
Raw x402 terms
[
{
"scheme": "exact",
"network": "eip155:8453",
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"amount": "9000",
"payTo": "0x19824cf672f28fa63024731ebc7405aa3733e0ba"
}
]Observed health
- Status
- Healthy
- Latest latency
- 279 ms
- Average latency
- 753 ms
- HTTP status
- 200
- Last checked
- Reachability
- 92.9% over 14 checks
Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.
Input schema
{
"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 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"
}