v1

latestOpenAPI 3.1.02026-07-2496304466.3 KB
Businesses

Create Business

post/businesses

Headers

LMG-Data-Privacy-Access-Principalstring required
LMG-Data-Privacy-Access-Justificationstring required

Request body

namestring required

The legal name of the business as formally registered.

fatca_relevantboolean required

A boolean value indicating if the legal entity is subject to FATCA (Foreign Account Tax Compliance Act). Provide true if either: (1) the legal entity is a US Person according to IRS definition, or (2) any shareholder who is a US Person holds >10% of the legal entity. Otherwise, provide false.

expected_annual_revenuestring number required

An estimate of the annual revenue of the business.

currencystring required

An ISO 4217 three-letter currency code. Its value represents the currency for expected_annual_revenue. The only currently available currency is "EUR".

legal_entity_identifierstring

An ISO 17442 Legal Entity Identifier (LEI) assigned to the legal entity.

single_tier_ownershipboolean

A boolean value indicating single tier ownership, i.e. true whether the business is directly owned by individuals only (true), or if there are companies in the ownership structure (false). Required only for KYC reliance partners.

nfe_type'active' | 'passive' required

A category describing the business model of Non-Financial Entities (NFE):

<ul> <li><code>active</code> <li><code>passive</code> </ul>

Example request

{
  "name": "Wayne Enterprises, Inc.",
  "registration": {
    "incorporation_country": "DE"
  },
  "registered_address": {
    "line_1": "Heidestraße 17",
    "postal_code": "51147",
    "city": "Köln",
    "country": "DE"
  },
  "currency": "EUR"
}

Response

Successful Response

idstring required

The unique identifier for this business.

namestring required

The legal name of the business as formally registered.

fatca_relevantboolean

A boolean value indicating if the legal entity is subject to FATCA (Foreign Account Tax Compliance Act). Provide true if either: (1) the legal entity is a US Person according to IRS definition, or (2) any shareholder who is a US Person holds >10% of the legal entity. Otherwise, provide false.

expected_annual_revenuestring number

An estimate of the annual revenue.

currencystring

An ISO 4217 three-letter currency code. Its value represents the currency for expected_annual_revenue. The only currently available currency is "EUR".

legal_entity_identifierstring

An ISO 17442 Legal Entity Identifier (LEI) assigned to the legal entity.

single_tier_ownershipboolean nullable

A boolean value indicating single tier ownership, i.e. true whether the business is directly owned by individuals only (true), or if there are companies in the ownership structure (false). Required only for KYC reliance partners.

nfe_type'active' | 'passive'

A category describing the business model of Non-Financial Entities (NFE):

<ul> <li><code>active</code> <li><code>passive</code> </ul>

Example response

{
  "name": "Wayne Enterprises, Inc.",
  "registration": {
    "incorporation_country": "DE"
  },
  "registered_address": {
    "line_1": "Heidestraße 17",
    "postal_code": "51147",
    "city": "Köln",
    "country": "DE"
  },
  "currency": "EUR"
}