Get Company Information
Access a wide range of company public information
Required inputs
Country ID
By an international system of https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2
| State | ISO 3166-1 alpha-2 |
|---|---|
| Czech Republic | CZ |
| Poland | PL |
| Slovakia | SK |
Registration number
| State | Company ID |
|---|---|
| Czech Republic | IČO - Identifikační číslo osoby |
| Poland | REGON - Rejestr Gospodarki Narodowej |
| Slovakia | IČO - Identifikačné číslo organizácie |
What can you set?
| Data scope | Content |
|---|---|
| Empty | The setting will be set to the default state, which in this case means 'Full'. |
| 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 |
| 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?
Make sure, that you are sending valid IDs in your queries, otherwise, you might as a result face an issue where the number of responses and the data you receive don’t match the number of queries you sent. In case you are providing us with an incorrect ID, the response will return empty.
Basic
json
{
"errors": [],
"status": 200,
"request": {
"code": "bd2050d6-021f-4214-9bcd-c258b6af7290",
"endpoint": "company/get"
},
"response": {
"results": [
{
"data": {
"name": "AVANTRO s.r.o.",
"uuid": "ca3665de-ded1-47f7-9bcd-b8c3eb0c5...",
"address": {
"data": {
"ids": { "external": "22349995", "internal": "d2ade877-1e95-4a83-ba..." },
"zip": "18600",
"city": "Praha 8",
"full": "Thámova 137/16, 18600 Praha 8",
"number": { "full": "137/16", "part1": "137", "part2": "16", "part1Letter": null, "part1Number": "137", "part2Letter": null, "part2Number": "16" },
"street": "Thámova",
"country": "CZ",
"streetWithNumber": "Thámova 137/16"
}
},
"country": "CZ",
"taxNumber": null,
"vatNumber": "CZ04997476",
"addressOfficial": {
"data": {
"zip": "18600",
"city": "Praha",
"full": "Thámova 137/16, Karlín, 18600 Pra...",
"number": { "full": "137/16", "part1": null, "part2": null, "part1Letter": null, "part1Number": null, "part2Letter": null, "part2Number": null },
"street": "Thámova",
"country": "CZ",
"streetWithNumber": "Thámova 137/16"
}
},
"vatNumberSpecial": null,
"registrationNumber": "04997476"
}
}
]
}
}
Extended
json
{
"status": 200,
"request": { "endpoint": "company/get", "code": "d225ba67-7e1a-43f3-95a4-c79fe3bf4bc1" },
"response": {
"results": [
{
"data": {
"uuid": "ca3665de-ded1-47f7-9bcd-b8e3b8c5...",
"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 }
}
}
]
}
}
Full
A schema reference — field values here are placeholders ([Sample], visible as such in the source screenshot), not a real response. A handful of placeholder VALUES were cut off at the panel's right edge in the source image and could not be read; these fields are listed by name only.
json
{
"response": {
"results": [
{
"data": {
"country": "[Sample]", "name": "[Sample]", "registrationNumber": "[Sample]",
"taxNumber": "[Sample]", "vatNumber": "[Sample]", "vatNumberSpecial": "[Sample]",
"address": {
"data": {
"country": "[Sample]", "region": "[Sample]", "district": "[Sample]",
"cityDistrictSpecial": "[Sample]", "cityDistrict": "[Sample]", "cityPart": "[Sample]",
"cityAdministrative": "[Sample]", "cadastralArea": "[Sample]",
"ids": { "internal": "[Sample]", "external": "[Sample]", "region": "[Sample]", "district": "[Sample]", "cityDistrictSpecial": "[Sample]", "cityDistrict": "[Sample]", "cityPart": "[Sample]", "cadastralArea": "[Sample]", "city": "[Sample]", "street": "[Sample]" },
"street": "[Sample]",
"number": { "part1": "[Sample]", "part1Number": "[Sample]", "part1Letter": "[Sample]", "part2": "[Sample]", "part2Number": "[Sample]", "part2Letter": "[Sample]", "full": "[Sample]" },
"streetWithNumber": "[Sample]", "city": "[Sample]", "zip": "[Sample]",
"geometry": { "gps": { "lat": 50, "lon": 14 }, "custom": [{ "type": "JTSK", "coordinates": { "x": 1000000000, "y": 700000 } }] },
"postOffice": { "name": "[Sample] Praha 86", "full": "[Sample] Thámova 137/16, ..." }
}
},
"addressOfficial": {
"data": {
"country": "[Sample]", "region": "[Sample]", "district": "[Sample]", "cityPart": "[Sample]",
"ids": { "internal": "[Sample]", "external": "[Sample]", "region": "[Sample]", "district": "[Sample]", "cityPart": "[Sample]", "city": "[Sample]", "street": "[Sample]" },
"number": { "part1": "[Sample]", "part1Number": "[Sample]", "part1Letter": "[Sample]", "part2": "[Sample]", "part2Number": "[Sample]", "part2Letter": "[Sample]", "full": "[Sample]" },
"streetWithNumber": "[Sample]", "city": "[Sample]", "zip": "[Sample]",
"geometry": { "gps": { "lat": 50, "lon": 14 }, "custom": [{ "type": "JTSK", "coordinates": { "x": 100000, "y": 500000 } }] },
"postOffice": { "name": "[Sample] Radslavice", "full": "[Sample] V Zahradách..." },
"function": "[Sample] jednatel", "birthDate": "[Sample] 1990-04-15", "registrationNumber": "[Sample]"
}
},
"nace": [{ "code": "00", "name": "[Sample] Výroba, obchod a slu...", "isPrimary": true }],
"databoxes": [{ "code": "txutpba", "name": "[Sample] AVANTRO s.r.o.", "receivingMessages": true }],
"registrations": [{ "type": "businessRegister", "data": { "register": { "code": null, "name": null, "detail": null }, "registrator": { "code": null, "name": "[Sample] Městský soud ...", "detail": null }, "reference": "C 256795" } }],
"legalForm": { "code": "112", "name": "[Sample] Společnost s ručením..." },
"legalFormSpecific": { "code": "112", "name": "[Sample] Společnost s ručením..." },
"esa2010": { "code": "11002", "name": "[Sample] Nefinanční podniky ..." },
"dates": { "created": "2016-04-15", "terminated": "2016-04-15" },
"employees": { "category": "[Sample] 1-5", "count": 3 },
"insolvency": [],
"businessPremises": [1],
"authority": [{ "name": "[Sample] Statutární orgán" }],
"members": [{
"name": "[Sample] Jan Novák",
"address": {
"data": {
"country": "[Sample] CZ", "region": "[Sample] Olomoucký", "district": "[Sample] Přerov",
"cityPart": "[Sample] Radslavice",
"ids": { "internal": "[Sample]", "external": "[Sample]", "region": "[Sample]", "district": "[Sample]", "cityPart": "[Sample]", "city": "[Sample]", "street": "[Sample] V Zahradách" },
"number": { "part1": "[Sample] 277", "part1Number": "[Sample] 27...", "part1Letter": null, "part2": null, "part2Number": null, "part2Letter": null, "full": "[Sample] 277" },
"streetWithNumber": "[Sample]", "city": "[Sample] Radslavice", "zip": "[Sample] 75111",
"geometry": { "gps": { "lat": 50, "lon": 14 }, "custom": [{ "type": "JTSK", "coordinates": { "x": 100000, "y": 500000 } }] },
"postOffice": { "name": "[Sample] Radslavice", "full": "[Sample] V Zahradách..." }
}
}
}],
"decisions": ["[Sample] Společnost zastupu..."],
"capital": { "value": { "amount": 200000, "currency": "CZK" } },
"shareholders": [{ "shareholder": "[Sample] Jan Novák", "share": { "amount": 200000, "currency": "czk", "percent": 100, "percentPaid": 100 } }],
"info": ["..."],
"stocks": ["..."],
"tradeLicences": [{
"type": "[Sample] Ohlašovací volná",
"name": "[Sample] Výroba, obchod a sl...",
"valid": { "from": "2016-04-15", "fromText": null, "to": "2016-04-15", "toText": null },
"interrupted": { "from": "2016-04-15", "to": "2016-04-15" },
"responsiblePerson": null,
"activitySubjects": ["[Sample] Poskytování služeb"]
}],
"vat": { "status": "[Sample] payer", "reliability": { "reliable": true, "unreliableFrom": null } },
"bankAccounts": [{ "number": "CZ89201000000..." }],
"history": [{ "vatNumber": "CZ04997476", "registrationType": "[Sample]", "validFrom": "2017-09-01", "validTo": "2017-09-01", "isGroupRegistration": "[Sample]" }]
}
}
]
}
}