GET
/
companies
/
identify
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": "commercial",
      "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
        }
      ],
      "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"
    }
  }
]

Authorizations

​
X-API-KEY
string
header
required

Query Parameters

​
legal_name
string

The legal_name of the company

Example:

"CrossLend GmbH"

​
address
string

The address of the business, partial or full address

Example:

"CrossLend GmbH"

​
vat_number
string

The VAT number of the business

Example:

"DE123456789"

​
registry_profile
enum<string>

The level of details to be returned

Available options:
FULL,
BASIC
Example:

"FULL"

​
country_code
string

The country code of the business, in alpha-2 format (ISO 3166-1 alpha-2)

Example:

"DE"

Response

200
application/json

OK

The response is of type object[].