Skip to main content
GET
identify

Authorizations

X-API-KEY
string
header
required

Query Parameters

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"

register_number
string

The company registration number (e.g. Companies House number for UK, SIRET for FR, P.IVA or REA code for IT). Must be combined with country_code.

Example:

"12345678"

registry_infocamere_enabled
boolean
default:false

When true, enables the Infocamere registry source for Italian companies. Only relevant when identifying Italian companies via register_number or vat_number.

Example:

true

validate_address
boolean
default:false

When true, validates and normalises the returned address against a reference dataset.

Example:

false

Response

OK

name
string
required
Example:

"XYZZ GmbH"

Example:

"GmbH"

register
object
required
address
object
required
ownership
object
required
source
object
required
status
enum<string>
Available options:
ACTIVE,
REGISTERED,
INACTIVE,
SUSPENDED,
IN_REGISTRATION,
TERMINATED
Example:

"ACTIVE"

commercial_name
string
is_blocked
boolean
default:false
description
string
Example:

"SOFTWARE CONSULTANCY"

vat_number
string
representation_rules
string
Example:

"This is a placeholder for representation rules."

signatory_powers
object[]
industry_classifications
object
pec
string
Example:

"QUADERNOAQUADRETTISRL@ARUBAPEC.IT"

rea_code
string
Example:

"128207"

financials
object
extras
object[]