Validate a Company

Validate company data and automatically correct most typos

Required inputs

For validation of a company, you need at least one of these required information.

Country ID

By an international system of https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2

Company name	Content
"Name of a company"	For example: Avantro s.r.o.

Company registration number (ID)

State	Company ID
Czech Republic	IČO - Identifikační číslo osoby
Poland	REGON - Rejestr Gospodarki Narodowej
Slovakia	IČO - Identifikačné číslo organizácie

TAX number

State	Company TAX number
Czech Republic	Is not used in the Czech Republic
Poland	NIP - numer identyfikacji podatkowej
Slovakia	DIČ - Only used for income tax

What can you set?

Data scope	Content
Empty	The setting will be set to the default state, which in this case means 'Basic'.
Basic	Retrieve the company name, tax numbers (including VAT numbers), and address data from the official registry.
Extended	The extended data scope provides the same information as the basic version but with additional details about the company's legal form and operations. For example, it includes NACE codes, trade license information, and more. The availability of this data varies depending on the country. For information on availability, refer to the company data scopes.
Full	The full data scope provides the same information as both the basic and extended versions but with more detailed coverage. For example, it includes databoxes, business premises, and additional information. The availability of this data varies depending on the country. For more details about availability, refer to the company data scopes .

Data source	Content
CZ	Companies registered in the Czech Republic
PL	Companies registered in Poland
PL	Companies registered in Slovakia

Results limit	Content
10	Results limit of response. You can choose the limit of results for the /search endpoints as well as the limit of suggestions for the

Include terminated subjects	Content
Yes	Include entities that have already ended their existence in the output.
No	Exclude entities that have already ended their existence in the output.
Empty	The setting will be set to the default state, which in this case means 'No'.

ZIP format	Content
Yeas	The ZIP Code in response should be formatted - 130 00
No	The ZIP Code in response should not be formatted - 13000
Empty	The setting will be set to the default state, which in this case means 'No'.

City format	Content
Empty	The setting will be set to the default state, which in this case means 'Basic'.
Minimal	Praha
Basic	Praha 8
Extended	Praha 8 - Karlín.

What can you find in the response?

Basic

json

{ "status": 200, "request": { "endpoint": "company/validate", "code": "0c8c7aa3-ce8d-4e55-9ea6-7e6ddcb218bb" }, "response": { "result": { "isValid": null, "proposal": "invalidWithCorrection", "data": { "uuid": null, "country": "CZ", "name": "avantro", "registrationNumber": "04997476", "taxNumber": null, "vatNumber": null, "vatNumberSpecial": null, "address": null, "addressOfficial": null }, "errors": [ { "group": "FORMAT", "type": "CHARACTERS", "subtype": "CASE_SENSITIVITY", "severity": "warning", "relatedTo": ["name"], "description": "Invalid case sensitivity. Specific..." } ], "resultCorrected": { "isValid": true, "data": { "uuid": "ca3665de-ded1-47f7-9bcd-b8c3eb0c5...", "country": "CZ", "name": "AVANTRO s.r.o.", "registrationNumber": "04997476", "taxNumber": null, "vatNumber": "CZ04997476", "vatNumberSpecial": null, "address": { "data": { "country": "CZ", "ids": { "internal": "d2ade877-1e95-4a83-baa...", "external": "22349995" }, "street": "Thámova", "number": { "part1": "137", "part1Number": "137", "part1Letter": null, "part2": "16", "part2Number": "16", "part2Letter": null, "full": "137/16" }, "streetWithNumber": "Thámova 137/16", "city": "Praha 8", "zip": "18600", "full": "Thámova 137/16, 18600 Praha 8" } }, "addressOfficial": { "data": { "country": "CZ", "street": "Thámova", "number": { "part1": null, "part1Number": null, "part1Letter": null, "part2": null, "part2Number": null, "part2Letter": null, "full": "137/16" }, "streetWithNumber": "Thámova 137/16", "city": "Praha", "zip": "18600", "full": "Thámova 137/16, Karlín, 18600 Pra..." } }, "errors": [] } }, "fixes": [ { "group": "FORMAT", "type": "CHANGED", "subtype": "CASE_SENSITIVITY", "data": { "typeFrom": "name", "type": "name", "valueFrom": "avantro s.r.o.", "value": "AVANTRO s.r.o." } } ], "suggestions": [], "errors": [] } } }

Extended

json

{ "status": 200, "request": { "endpoint": "company/validate", "code": "af6578c4-9fb3-48d7-973b-93276bb301d0" }, "response": { "result": { "isValid": null, "proposal": "invalidWithCorrection", "data": { "country": "CZ", "name": "avantro", "registrationNumber": "04997476", "taxNumber": null, "vatNumber": null, "vatNumberSpecial": null, "address": null, "addressOfficial": null, "nace": [], "registrations": [], "legalForm": { "code": null, "name": null }, "legalFormSpecific": { "code": null, "name": null }, "esa2010": { "code": null, "name": null }, "dates": { "created": null, "terminated": null }, "tradeLicences": [], "vat": { "status": null, "reliability": { "reliable": null, "unreliableFrom": null } }, "bankAccounts": [], "history": [], "errors": [] }, "errors": [ { "group": "FORMAT", "type": "CHARACTERS", "subtype": "CASE_SENSITIVITY", "severity": "warning", "relatedTo": ["name"], "description": "Invalid case sensitivity. Specific..." } ], "resultCorrected": { "isValid": true, "data": { "uuid": "ca3665de-ded1-47f7-9bcd-b8c3eb0c5...", "country": "CZ", "name": "AVANTRO s.r.o.", "registrationNumber": "04997476", "taxNumber": null, "vatNumber": "CZ04997476", "vatNumberSpecial": null, "address": { "data": { "country": "CZ", "ids": { "internal": "d2ade877-1e95-4a83-ba...", "external": "22349995" }, "street": "Thámova", "number": { "part1": "137", "part1Number": "137", "part1Letter": null, "part2": "16", "part2Number": "16", "part2Letter": null, "full": "137/16" }, "streetWithNumber": "Thámova 137/16", "city": "Praha 8", "zip": "18600", "full": "Thámova 137/16, 18600 Praha 8" } }, "addressOfficial": { "data": { "country": "CZ", "street": "Thámova", "number": { "part1": null, "part1Number": null, "part1Letter": null, "part2": null, "part2Number": null, "part2Letter": null, "full": "137/16" }, "streetWithNumber": "Thámova 137/16", "city": "Praha", "zip": "18600", "full": "Thámova 137/16, Karlín, 18600 Pra..." } }, "nace": [{ "code": "74", "name": "Ostatní profesní, vědecké a technické...", "isPrimary": null }], "registrations": [{ "type": "vatRegister", "data": { "register": { "code": null, "name": null, "detail": null }, "registrator": { "code": "008", "name": "Územní pracoviště pro Prahu 8", "detail": null }, "reference": "C 256795" } }], "legalForm": { "code": "112", "name": "Společnost s ručením omezeným" }, "legalFormSpecific": { "code": null, "name": null }, "esa2010": { "code": "11002", "name": "Národní soukromé nefinanční podniky..." }, "dates": { "created": "2016-04-15", "terminated": null }, "tradeLicences": [{ "type": "živnost volná", "name": "Výroba, obchod a služby neuvedené...", "valid": { "from": "2016-04-15", "fromText": null, "to": null, "toText": null }, "interrupted": { "from": null, "to": null }, "responsiblePerson": null, "activitySubjects": ["Povrchové úpravy a svařování kovů..."] }], "vat": { "status": "payer", "reliability": { "reliable": true, "unreliableFrom": null } }, "bankAccounts": [{ "number": "CZ6620100000002902049845" }], "history": [], "errors": [] } }, "fixes": [ { "group": "FORMAT", "type": "CHANGED", "subtype": "CASE_SENSITIVITY", "data": { "typeFrom": "name", "type": "name", "valueFrom": "avantro s.r.o.", "value": "AVANTRO s.r.o." } } ], "suggestions": [], "errors": [] } } }

Full

Neověřeno: tento obrázek (validate-a-company_Full.png, "Full" sekce) se nepodařilo přečíst — zdrojový screenshot je příliš dlouhý a drobný (400×6292 px škálováno na jednu stránku), text je pod rozlišením čitelnosti. Struktura "Full" úrovně je vidět v Get Company Information → Full (stejná pole, stejný endpoint), na kterou tato stránka výše stejně odkazuje.