API Reference
Data PrivacyImprint

Create Business

post
https://sandbox.api.lemon.markets/v1/businesses
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Request object for creating a business record in the system.

string
required
length between 1 and 255

The legal name of the business as formally registered.

registration
required

Base class for business registration requests, adapting constraints and fields based on the incorporation_country. For example, German businesses are validated using the GermanBusinessRegistration schema with additional required fields.

industry
object
required
registered_address
object
required
taxation_countries
array of objects
required
length ≥ 1

A complete list of all tax residencies. It is critical that this list is exhaustive.

Taxation Countries*
string
required
length between 2 and 2

An ISO 3166-1 alpha-2 code, representing a business's tax residency.

string
required
length between 1 and 255

The business's tax number, eg. 123/456/78901.

string
^[A-Za-z]{2}\d{2,13}$

The company's identifier for VAT (value added tax).

string
length between 1 and 255

Reserved for future use, pass null for now.

boolean
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.

string
required

An estimate of the annual revenue of the business.

string
required
length between 3 and 3

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

string
length between 20 and 20

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

boolean

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.

string
enum
required

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

  • active
  • passive
Allowed:
Headers
string
required
string
required
Responses

Updated 3 months ago

Did this page help you?
Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 3 months ago

Did this page help you?