Sign in

v1

latestOpenAPI 3.1.02026-07-26549156879.0 KB
Companies > LegalEntity

Creates a Legal entity

Creates a Legal entity

post/api/2026-07-01/resources/companies/legal_entities

Request body

company_idstring required

company identifier

countrystring required

country code of the legal entity

legal_namestring required

Legal name of the legal entity

currencystring required

The currency code in ISO 4217 format

tinstring

Tax identification number

citystring

City of the legal entity

statestring

State of the legal entity

postal_codestring

Postal code of the legal entity

address_line_1string

Address line 1 of the legal entity

address_line_2string

Address line 2 of the legal entity

Example request

{
  "company_id": "1",
  "country": "es",
  "legal_name": "Acme Inc.",
  "currency": "EUR",
  "tin": "H41192410",
  "city": "Barcelona",
  "state": "Barcelona",
  "postal_code": "08005",
  "address_line_1": "Carrer Mallorca",
  "address_line_2": "61 2A"
}

Response

CREATED

idstring required

identifier of the legal entity

company_idstring required

company identifier

countrystring required

Country code of the jurisdiction the legal entity is registered in (lowercase two-letter code, e.g. "es").

legal_namestring required

Legal name of the legal entity

currencystring required

The currency code in ISO 4217 format

tinstring

Tax identification number

citystring

City of the legal entity

statestring

State of the legal entity

postal_codestring

Postal code of the legal entity

address_line_1string

Address line 1 of the legal entity

address_line_2string

Address line 2 of the legal entity

Example response

{
  "id": "754",
  "company_id": "1",
  "country": "es",
  "legal_name": "Acme Inc.",
  "currency": "EUR",
  "tin": "H41192410",
  "city": "Barcelona",
  "state": "Barcelona",
  "postal_code": "08005",
  "address_line_1": "Carrer Mallorca",
  "address_line_2": "61 2A"
}