curl --request GET \
--url https://api.godiligent.ai/companies/identify \
--header 'X-API-KEY: <api-key>'
[
{
"status": "ACTIVE",
"name": "XYZZ GmbH",
"commercial_name": "<string>",
"is_blocked": false,
"legal_form": "GmbH",
"description": "SOFTWARE CONSULTANCY",
"register": {
"id": "HRB 259538 B",
"country": "DE",
"city": "Charlottenburg (Berlin)",
"foundation_date": "2023-12-04"
},
"address": {
"formatted_address": "123 Imaginary St, 45678 Fictional City",
"components": {
"street": "Imaginary St",
"street_number": "123",
"state": "IS",
"locality_code": "IS",
"city": "Fictional City",
"postal_code": "45678",
"country_code": "FC",
"country": "Fictionland"
},
"type": "residential",
"is_valid": true,
"is_verified": true,
"is_suspicious": false,
"is_blacklisted": false,
"is_primary": true,
"street_view": "<string>",
"sources": [
{
"name": "Source Name",
"link": "https://www.example.com"
}
]
},
"vat_number": "<string>",
"representation_rules": "This is a placeholder for representation rules.",
"signatory_powers": [
{
"first_name": "John",
"last_name": "Doe",
"date_of_birth": "1990-01-01",
"entity_name": "Example GmbH",
"location": "City, Country",
"role": "ROLE",
"effective_date": "2024-01-01",
"representation": "Representation details",
"role_local": "Role",
"signatory_power": "POWER_TYPE"
}
],
"ownership": {
"shareholders": [
{
"name": "John Doe",
"percentage": 100,
"type": "INDIVIDUAL",
"location": "City, Country",
"is_major_shareholder": true,
"is_ubo": true,
"gender": "MALE",
"tax_code": "123456789",
"address": "123 Main St, City, Country"
}
],
"total_percentage": 100,
"total_shareholders_count": 1,
"total_major_shareholders_count": 1,
"total_ubos_count": 1
},
"industry_classifications": {
"ateco": [
"47199"
],
"nace": [
"4719"
],
"sic": [
"5999"
]
},
"pec": "QUADERNOAQUADRETTISRL@ARUBAPEC.IT",
"rea_code": "128207",
"financials": {
"date": "2022-12-31",
"items": [
{
"id": "share_capital",
"note": "<string>",
"unit": "EUR",
"value": 100000
}
]
},
"extras": [
{
"name": "website",
"value": "www.example.eu"
}
],
"source": {
"name": "Source Name",
"link": "https://www.example.com"
}
}
]
Get company by various data points
curl --request GET \
--url https://api.godiligent.ai/companies/identify \
--header 'X-API-KEY: <api-key>'
[
{
"status": "ACTIVE",
"name": "XYZZ GmbH",
"commercial_name": "<string>",
"is_blocked": false,
"legal_form": "GmbH",
"description": "SOFTWARE CONSULTANCY",
"register": {
"id": "HRB 259538 B",
"country": "DE",
"city": "Charlottenburg (Berlin)",
"foundation_date": "2023-12-04"
},
"address": {
"formatted_address": "123 Imaginary St, 45678 Fictional City",
"components": {
"street": "Imaginary St",
"street_number": "123",
"state": "IS",
"locality_code": "IS",
"city": "Fictional City",
"postal_code": "45678",
"country_code": "FC",
"country": "Fictionland"
},
"type": "residential",
"is_valid": true,
"is_verified": true,
"is_suspicious": false,
"is_blacklisted": false,
"is_primary": true,
"street_view": "<string>",
"sources": [
{
"name": "Source Name",
"link": "https://www.example.com"
}
]
},
"vat_number": "<string>",
"representation_rules": "This is a placeholder for representation rules.",
"signatory_powers": [
{
"first_name": "John",
"last_name": "Doe",
"date_of_birth": "1990-01-01",
"entity_name": "Example GmbH",
"location": "City, Country",
"role": "ROLE",
"effective_date": "2024-01-01",
"representation": "Representation details",
"role_local": "Role",
"signatory_power": "POWER_TYPE"
}
],
"ownership": {
"shareholders": [
{
"name": "John Doe",
"percentage": 100,
"type": "INDIVIDUAL",
"location": "City, Country",
"is_major_shareholder": true,
"is_ubo": true,
"gender": "MALE",
"tax_code": "123456789",
"address": "123 Main St, City, Country"
}
],
"total_percentage": 100,
"total_shareholders_count": 1,
"total_major_shareholders_count": 1,
"total_ubos_count": 1
},
"industry_classifications": {
"ateco": [
"47199"
],
"nace": [
"4719"
],
"sic": [
"5999"
]
},
"pec": "QUADERNOAQUADRETTISRL@ARUBAPEC.IT",
"rea_code": "128207",
"financials": {
"date": "2022-12-31",
"items": [
{
"id": "share_capital",
"note": "<string>",
"unit": "EUR",
"value": 100000
}
]
},
"extras": [
{
"name": "website",
"value": "www.example.eu"
}
],
"source": {
"name": "Source Name",
"link": "https://www.example.com"
}
}
]
The legal_name of the company
"CrossLend GmbH"
The address of the business, partial or full address
"CrossLend GmbH"
The VAT number of the business
"DE123456789"
The level of details to be returned
FULL
, BASIC
"FULL"
The country code of the business, in alpha-2 format (ISO 3166-1 alpha-2)
"DE"
OK
The response is of type object[]
.