How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

lemon.markets Businesses API

The Businesses API from lemon.markets — 5 operation(s) for businesses.

lemon.markets Businesses API is one of 17 APIs that lemon.markets publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Businesses. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, a getting-started guide, and a changelog.

This API exposes 8 operations across 5 paths, and defines 33 schemas. It is described by OpenAPI 3.2.0, at version 0.1.0.

Requests are made against a single base URL, https://sandbox.api.lemon.markets/v1.

8 operations 5 paths 33 schemas 4 GET4 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
0.1.0
Base URL
https://api.lemon.markets/v1
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

lemon.markets Businesses API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (bearerAuth).

Paths & Operations 8

Across 5 paths, the API surfaces 8 operations — 4 GET, 4 POST. Each is listed below with its method, path, parameters, and response codes.

Businesses 8
POST
/businesses/{business_id}/beneficial_owners
Add Beneficial Owner
add_beneficial_owner 3 params body → 2014004014044225XX
GET
/businesses/{business_id}/beneficial_owners
List Beneficial Owners
list_beneficial_owners 5 params → 2004004014044225XX
POST
/businesses/{business_id}/legal_representatives
Add Legal Representative
add_legal_representative 3 params body → 2014004014044225XX
GET
/businesses/{business_id}/legal_representatives
List Legal Representatives
list_legal_representatives 5 params → 2004004014044225XX
POST
/businesses
Create Business
create_business 2 params body → 2014004014044225XX
GET
/businesses
List Businesses
list_businesses 4 params → 2004004014044225XX
GET
/businesses/{business_id}
Get Business
get_business 3 params → 2004004014044225XX
POST
/businesses/{business_id}/submit_documentdeprecated
Submit Document
submit_document 3 params body → 2014004014044225XX

Schemas 33

The contract defines 33 schemas that model the data the API accepts and returns. The most detailed are BusinessResponse (12 properties), BusinessRequest (11 properties), BeneficialOwnerResponse (5 properties), Address (5 properties). Each schema is shown below with its type and property counts.

RepresentationRule
string
A category describing the representation rule for a legal representative: solerepresentation : The legal representative alone can represent the company. jointr…
BeneficialOwnerNature
string
A category describing the nature of a UBO: real notional
BusinessDocumentUploadResponse
object
3 properties 3 required
BusinessResponse
object
Response object representing a business record returned from the API.
12 properties 5 required
BusinessIndustry
object
A specification of an industry sector.
2 properties 2 required
BusinessDocumentType
string
A category describing the a business document: articlesofassociation commercialregisterextract shareholderlist
ErrorResponse
object
1 property 1 required
BusinessDocumentUploadRequest
object
1 property 1 required
EncodedPaginatedCollectionResponse_LegalRepresentativeResponse_
object
2 properties 2 required
BusinessNFETypeEnum
string
A category describing the business model of Non-Financial Entities (NFE): active passive
BusinessRequest
object
Request object for creating a business record in the system.
11 properties 9 required
BusinessRegistrationResponse
object
Business registration information as returned in API responses.
IndustryRequest
object
2 properties 2 required
GenericBusinessRegistrationResponse
object
3 properties 3 required
BusinessIndustryCodeEnumTwo
string
An industry sector identifier, according to NACE rev 2 (2006).
GermanBusinessRegistration
object
5 properties 4 required
BusinessRegistrationRequest
object
Base class for business registration requests, adapting constraints and fields based on the incorporationcountry. For example, German businesses are validated…
EncodedPaginatedCollectionResponse_BeneficialOwnerResponse_
object
2 properties 2 required
LegalRepresentativeRequest
object
2 properties 2 required
GenericBusinessRegistrationRequest
object
3 properties 3 required
EncodedPaginationResponse
object
Information about accessing elements beyond the ones that were returned.
1 property
BeneficialOwnerRequest
object
4 properties 3 required
AddressRequest
object
5 properties 4 required
BusinessTaxResidencyResponse
object
4 properties 2 required
IndustryRequestNaceRev
string
A category representing a revision of the NACE classification codes. Only NACE Rev. 2.1 (2025) is supported for new business requests.
BeneficialOwnerResponse
object
5 properties 4 required
BusinessIndustryNaceRev
string
A category representing a revision of the NACE classification codes: "2" : NACE Rev. 2 (2008) "2.1" : NACE Rev. 2.1 (2025)
BusinessIndustryCodeEnumTwoOne
string
An industry sector identifier, according to NACE rev 2.1 (2025).
Address
object
A residential address.
5 properties 4 required
GermanBusinessLegalForm
string
A category representing the formal type of a German legal entity: gmbh : GmbH ug : UG (haftungsbeschränkt)
BusinessTaxResidencyRequest
object
4 properties 2 required
EncodedPaginatedCollectionResponse_BusinessResponse_
object
2 properties 2 required
LegalRepresentativeResponse
object
3 properties 3 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

lemonmarkets-businesses-api-openapi.yml Raw ↑

Other APIs lemon.markets publishes across the network.

lemon.markets Accounts: General API
lemon.markets Accounts: ID+V API
lemon.markets Batch Orders API
lemon.markets Cash Settlement API
lemon.markets Corporate Actions API
lemon.markets Documents API
lemon.markets Events + Webhooks API
lemon.markets Instruments API
lemon.markets Money + Positions API
lemon.markets Orders API
lemon.markets Persons API
lemon.markets Securities Accounts API
Where this information came from

This is an independent, third-party profile of lemon.markets Businesses API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.