Create a Legal Entity

Create a legal entity for your business.

Create a legal entity for your business

post

Create a legal entity for your business

Authorizations

bearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

namestringRequired

Business's name

Example: Example Palm Oil Trader

emailobject | nullableOptional

email of the contact person in the business

Example: [email protected]

addressCitystringRequired

City of the business's address

Example: West Papua

addressCountryCodestringRequired

Two-letter country code (ISO 3166 Alpha-2) of the business's address

Example: ID

addressLine1stringRequired

First line of the business address

Example: Salawati 123

addressLine2object | nullableRequired

Second line of the business address

Example: 2nd floor

addressPostcodestringRequired

Country-specific postcode of the business's address

Example: 12345

eoriobject | nullableOptional

EORI number of the business

vatobject | nullableOptional

VAT number of the business

Example: 1234567890asdfghjk

Responses

200

Returns the created legal entity.

application/json

400Error

401Error

403Error

post

/legal-entities

HTTPcURLJavaScriptPython

POST /legal-entities HTTP/1.1
Host: api.tradeaware.live-eo.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 234

{
  "name": "Example Palm Oil Trader",
  "email": "[email protected]",
  "addressCity": "West Papua",
  "addressCountryCode": "ID",
  "addressLine1": "Salawati 123",
  "addressLine2": "2nd floor",
  "addressPostcode": "12345",
  "eori": {},
  "vat": "1234567890asdfghjk"
}

{
  "name": "Example Palm Oil Trader",
  "email": "[email protected]",
  "addressCity": "West Papua",
  "addressCountryCode": "ID",
  "addressLine1": "Salawati 123",
  "addressLine2": "2nd floor",
  "addressPostcode": "12345",
  "eori": {},
  "vat": "1234567890asdfghjk",
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "createdAt": "2021-01-01T00:00:00.000Z",
  "updatedAt": "2021-01-01T00:00:00.000Z"
}