lemon.markets

lemon.markets Businesses API

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

GitHub OpenAPI

Operations 8

POST /businesses/{business_id}/beneficial_owners Add Beneficial Owner #
GET /businesses/{business_id}/beneficial_owners List Beneficial Owners #
POST /businesses Create Business #
GET /businesses List Businesses #
GET /businesses/{business_id} Get Business #
POST /businesses/{business_id}/submit_document Submit Document #

Documentation

📖
Documentation
https://developer.lemon.markets/docs
📖
APIReference
https://developer.lemon.markets/reference
📖
GettingStarted
https://developer.lemon.markets/docs/getting-started

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/lemonmarkets/refs/heads/main/openapi/lemonmarkets-businesses-api-openapi.yml

Other Resources

🔗
ChangeLog
https://developer.lemon.markets/changelog
🔗
Sandbox
https://raw.githubusercontent.com/api-evangelist/lemonmarkets/refs/heads/main/sandbox/lemonmarkets-sandbox.yml
🔗
Webhooks
https://raw.githubusercontent.com/api-evangelist/lemonmarkets/refs/heads/main/asyncapi/lemonmarkets-brokerage-webhooks.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/lemonmarkets-businesses-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

lemonmarkets-businesses-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: 'lemon.markets Brokerage API 🍋 Accounts: General Businesses API'
  version: 0.1.0
servers:
- url: https://sandbox.api.lemon.markets/v1
  description: Sandbox
tags:
- name: Businesses
paths:
  /businesses/{business_id}/beneficial_owners:
    post:
      summary: Add Beneficial Owner
      operationId: add_beneficial_owner
      tags:
      - Businesses
      parameters:
      - name: business_id
        in: path
        required: true
        schema:
          type: string
          title: Business Identifier
          description: 'A business identifier.

            '
      - name: LMG-Data-Privacy-Access-Principal
        in: header
        required: true
        schema:
          type: string
          title: Lmg-Data-Privacy-Access-Principal
      - name: LMG-Data-Privacy-Access-Justification
        in: header
        required: true
        schema:
          type: string
          title: Lmg-Data-Privacy-Access-Justification
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BeneficialOwnerRequest'
            example:
              shares_pct: '100'
              voting_rights_pct: '100'
              person: pers_310212a629b2429cacfdc09d212fa87a
              type: real
      responses:
        '201':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BeneficialOwnerResponse'
              example:
                id: ubo_ea20564620af48a4af367aca2ade4d91
                shares_pct: '100'
                voting_rights_pct: '100'
                person: pers_310212a629b2429cacfdc09d212fa87a
                nature: real
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Bad Request
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Unauthorized
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Not Found
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Unprocessable Entity
        5XX:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Server Error
    get:
      summary: List Beneficial Owners
      operationId: list_beneficial_owners
      tags:
      - Businesses
      parameters:
      - name: business_id
        in: path
        required: true
        schema:
          type: string
          title: Business Identifier
        description: 'A business identifier.

          '
      - name: cursor
        in: query
        required: false
        schema:
          type: string
          title: Cursor
        description: 'A pagination cursor.  When you receive a paginated response containing the property `pagination.next_cursor`, you can pass its value here to get the next page of results for your query.

          A cursor will include filter parameters, so there is not need to specify both the `cursor` and any other filter parameter.

          '
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          maximum: 100
          minimum: 1
          default: 100
          title: Limit
        description: 'In order to customize the number of elements returned, you can provide a limit here.  The service will not return more elements than specified.

          '
      - name: LMG-Data-Privacy-Access-Principal
        in: header
        required: true
        schema:
          type: string
          title: Lmg-Data-Privacy-Access-Principal
      - name: LMG-Data-Privacy-Access-Justification
        in: header
        required: true
        schema:
          type: string
          title: Lmg-Data-Privacy-Access-Justification
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EncodedPaginatedCollectionResponse_BeneficialOwnerResponse_'
              example:
                data:
                - id: ubo_ea20564620af48a4af367aca2ade4d91
                  shares_pct: '100'
                  voting_rights_pct: '100'
                  person: pers_310212a629b2429cacfdc09d212fa87a
                  type: real
                pagination:
                  next_cursor: null
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Bad Request
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Unauthorized
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Not Found
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Unprocessable Entity
        5XX:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Server Error
  /businesses/{business_id}/legal_representatives:
    post:
      summary: Add Legal Representative
      operationId: add_legal_representative
      tags:
      - Businesses
      parameters:
      - name: business_id
        in: path
        required: true
        schema:
          type: string
          title: Business Identifier
          description: 'A business identifier.

            '
      - name: LMG-Data-Privacy-Access-Principal
        in: header
        required: true
        schema:
          type: string
          title: Lmg-Data-Privacy-Access-Principal
      - name: LMG-Data-Privacy-Access-Justification
        in: header
        required: true
        schema:
          type: string
          title: Lmg-Data-Privacy-Access-Justification
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/LegalRepresentativeRequest'
            example:
              person: pers_310212a629b2429cacfdc09d212fa87a
              representation_rule: sole_representation
      responses:
        '201':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LegalRepresentativeResponse'
              example:
                id: rep_b4831949b797401bbc037a03f9a64d79
                person: pers_310212a629b2429cacfdc09d212fa87a
                representation_rule: sole_representation
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Bad Request
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Unauthorized
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Not Found
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Unprocessable Entity
        5XX:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Server Error
    get:
      summary: List Legal Representatives
      operationId: list_legal_representatives
      tags:
      - Businesses
      parameters:
      - name: business_id
        in: path
        required: true
        schema:
          type: string
          title: Business Identifier
          description: 'A business identifier.

            '
      - name: cursor
        required: false
        schema:
          title: Cursor
          type: string
        description: 'A pagination cursor.  When you receive a paginated response containing the property `pagination.next_cursor`, you can pass its value here to get the next page of results for your query.

          A cursor will include filter parameters, so there is not need to specify both the `cursor` and any other filter parameter.

          '
        in: query
      - name: limit
        required: false
        schema:
          title: Limit
          maximum: 100
          minimum: 1
          default: 100
          type: integer
        in: query
        description: 'In order to customize the number of elements returned, you can provide a limit here.  The service will not return more elements than specified.

          '
      - name: LMG-Data-Privacy-Access-Principal
        in: header
        required: true
        schema:
          type: string
          title: Lmg-Data-Privacy-Access-Principal
      - name: LMG-Data-Privacy-Access-Justification
        in: header
        required: true
        schema:
          type: string
          title: Lmg-Data-Privacy-Access-Justification
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EncodedPaginatedCollectionResponse_LegalRepresentativeResponse_'
              example:
                data:
                - id: rep_b4831949b797401bbc037a03f9a64d79
                  person: pers_310212a629b2429cacfdc09d212fa87a
                  representation_rule: sole_representation
                pagination:
                  next_cursor: null
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Bad Request
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Unauthorized
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Not Found
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Unprocessable Entity
        5XX:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Server Error
  /businesses:
    post:
      summary: Create Business
      operationId: create_business
      tags:
      - Businesses
      parameters:
      - name: LMG-Data-Privacy-Access-Principal
        in: header
        required: true
        schema:
          type: string
          title: Lmg-Data-Privacy-Access-Principal
      - name: LMG-Data-Privacy-Access-Justification
        in: header
        required: true
        schema:
          type: string
          title: Lmg-Data-Privacy-Access-Justification
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BusinessRequest'
            example:
              currency: EUR
              expected_annual_revenue: '123456.78'
              fatca_relevant: false
              industry:
                nace_rev: '2.1'
                code: T.96.22
              name: Beeswax UG (haftungsbeschränkt)
              nfe_type: active
              registered_address:
                city: Musterstadt
                country: DE
                line_1: Mustergasse 1a
                postal_code: '12345'
              registration:
                court: Musterstadt
                id: HRB 123456
                incorporation_country: DE
                incorporation_date: '2024-01-02'
                legal_form: ug
              single_tier_ownership: true
              taxation_countries:
              - country: DE
                business_identification_number: null
                tax_number: 123/456/78901
                vat_id: DE0815
      responses:
        '201':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BusinessResponse'
              example:
                currency: EUR
                expected_annual_revenue: '123456.78'
                fatca_relevant: false
                id: le_3a0baf04657b4fb9bcaa03d8120b5e9e
                industry:
                  nace_rev: '2.1'
                  code: T.96.22
                legal_entity_identifier: null
                name: Beeswax UG (haftungsbeschränkt)
                nfe_type: active
                registered_address:
                  city: Musterstadt
                  country: DE
                  line_1: Mustergasse 1a
                  line_2: null
                  postal_code: '12345'
                registration:
                  court: Musterstadt
                  id: HRB 123456
                  incorporation_country: DE
                  incorporation_date: '2024-01-02'
                  legal_form: ug
                single_tier_ownership: true
                taxation_countries:
                - country: DE
                  business_identification_number: null
                  tax_number: 123/456/78901
                  vat_id: DE0815
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Bad Request
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Unauthorized
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Not Found
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Unprocessable Entity
        5XX:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Server Error
    get:
      summary: List Businesses
      operationId: list_businesses
      tags:
      - Businesses
      parameters:
      - name: cursor
        in: query
        required: false
        schema:
          type: string
          title: Cursor
        description: 'A pagination cursor.  When you receive a paginated response containing the property `pagination.next_cursor`, you can pass its value here to get the next page of results for your query.

          A cursor will include filter parameters, so there is not need to specify both the `cursor` and any other filter parameter.

          '
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          maximum: 100
          minimum: 1
          default: 100
          title: Limit
        description: 'In order to customize the number of elements returned, you can provide a limit here.  The service will not return more elements than specified.

          '
      - name: LMG-Data-Privacy-Access-Principal
        in: header
        required: true
        schema:
          type: string
          title: Lmg-Data-Privacy-Access-Principal
      - name: LMG-Data-Privacy-Access-Justification
        in: header
        required: true
        schema:
          type: string
          title: Lmg-Data-Privacy-Access-Justification
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EncodedPaginatedCollectionResponse_BusinessResponse_'
              example:
                data:
                - currency: EUR
                  expected_annual_revenue: '123456.78'
                  fatca_relevant: false
                  id: le_3a0baf04657b4fb9bcaa03d8120b5e9e
                  industry:
                    nace_rev: '2.1'
                    code: T.96.22
                  legal_entity_identifier: null
                  name: Beeswax UG (haftungsbeschränkt)
                  nfe_type: active
                  registered_address:
                    city: Musterstadt
                    country: DE
                    line_1: Mustergasse 1a
                    line_2: null
                    postal_code: '12345'
                  registration:
                    court: Musterstadt
                    id: HRB 123456
                    incorporation_country: DE
                    incorporation_date: '2024-01-02'
                    legal_form: ug
                  single_tier_ownership: true
                  taxation_countries:
                  - country: DE
                    business_identification_number: null
                    tax_number: 123/456/78901
                    vat_id: DE0815
                pagination:
                  next_cursor: null
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Bad Request
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Unauthorized
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Not Found
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Unprocessable Entity
        5XX:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Server Error
  /businesses/{business_id}:
    get:
      summary: Get Business
      operationId: get_business
      tags:
      - Businesses
      parameters:
      - name: business_id
        in: path
        required: true
        schema:
          type: string
          title: Business Identifier
        description: 'A business identifier.

          '
        example: le_3a0baf04657b4fb9bcaa03d8120b5e9e
      - name: LMG-Data-Privacy-Access-Principal
        in: header
        required: true
        schema:
          type: string
          title: Lmg-Data-Privacy-Access-Principal
      - name: LMG-Data-Privacy-Access-Justification
        in: header
        required: true
        schema:
          type: string
          title: Lmg-Data-Privacy-Access-Justification
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BusinessResponse'
              example:
                currency: EUR
                expected_annual_revenue: '123456.78'
                fatca_relevant: false
                id: le_3a0baf04657b4fb9bcaa03d8120b5e9e
                industry:
                  nace_rev: '2.1'
                  code: T.96.22
                legal_entity_identifier: null
                name: Beeswax UG (haftungsbeschränkt)
                nfe_type: active
                registered_address:
                  city: Musterstadt
                  country: DE
                  line_1: Mustergasse 1a
                  line_2: null
                  postal_code: '12345'
                registration:
                  court: Musterstadt
                  id: HRB 123456
                  incorporation_country: DE
                  incorporation_date: '2024-01-02'
                  legal_form: ug
                single_tier_ownership: true
                taxation_countries:
                - country: DE
                  business_identification_number: null
                  tax_number: 123/456/78901
                  vat_id: DE0815
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Bad Request
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Unauthorized
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Not Found
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Unprocessable Entity
        5XX:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Server Error
  /businesses/{business_id}/submit_document:
    post:
      summary: Submit Document
      deprecated: true
      operationId: submit_document
      tags:
      - Businesses
      description: '**⚠️ DEPRECATED**: This endpoint is deprecated. Please use the new unified `/submit_document` endpoint instead, which supports both person and business documents through a discriminated union approach.


        See [Submit Document](/reference/submit_document_upload) for the replacement endpoint.

        '
      parameters:
      - name: business_id
        in: path
        required: true
        schema:
          type: string
          title: Business Identifier
          description: 'A business identifier.

            '
      - name: LMG-Data-Privacy-Access-Principal
        in: header
        required: true
        schema:
          type: string
          title: Lmg-Data-Privacy-Access-Principal
      - name: LMG-Data-Privacy-Access-Justification
        in: header
        required: true
        schema:
          type: string
          title: Lmg-Data-Privacy-Access-Justification
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BusinessDocumentUploadRequest'
            example:
              document: shareholder_list
      responses:
        '201':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BusinessDocumentUploadResponse'
              example:
                expires_at: '2024-11-18T13:36:09.478814+00:00'
                document: shareholder_list
                upload_url: https://example.com/upload-document-url-12345
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Bad Request
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Unauthorized
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Not Found
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Unprocessable Entity
        5XX:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Server Error
components:
  schemas:
    RepresentationRule:
      type: string
      enum:
      - sole_representation
      - joint_representation
      title: RepresentationRule
      description: 'A category describing the representation rule for a legal representative:

        <ul> <li><code>sole_representation</code>:  The legal representative alone can represent the company. <li><code>joint_representation</code>:  The legal representative needs at least one more legal representative to represent the company. </ul>

        '
    BeneficialOwnerNature:
      type: string
      enum:
      - real
      - notional
      title: BeneficialOwnerNature
      description: 'A category describing the nature of a UBO:

        <ul> <li><code>real</code> <li><code>notional</code> </ul>

        '
    BusinessDocumentUploadResponse:
      properties:
        document:
          $ref: '#/components/schemas/BusinessDocumentType'
        upload_url:
          type: string
          title: Upload URL
          description: 'A URL to upload the business document.

            Use this URL to upload a document with the HTTP method `PUT` and the content type header set to `application/pdf`.

            '
        expires_at:
          type: string
          format: date-time
          title: Expires At
          description: 'The expiry date for the upload link.  Please only create upload links for immediate uploads.

            '
      type: object
      required:
      - document
      - upload_url
      - expires_at
      title: BusinessDocumentUploadResponse
    BusinessResponse:
      type: object
      title: BusinessResponse
      description: 'Response object representing a business record returned from the API.

        '
      properties:
        id:
          type: string
          title: Business Identifier
          description: The unique identifier for this business.
        name:
          type: string
          title: Name
          description: The legal name of the business as formally registered.
          example: Wayne Enterprises, Inc.
        registration:
          $ref: '#/components/schemas/BusinessRegistrationResponse'
        industry:
          $ref: '#/components/schemas/BusinessIndustry'
        registered_address:
          $ref: '#/components/schemas/Address'
        taxation_countries:
          type: array
          items:
            $ref: '#/components/schemas/BusinessTaxResidencyResponse'
          title: Taxation Countries
          description: 'A **complete** list of all tax residencies.  It is important for this list to be exhaustive.

            '
        fatca_relevant:
          type: boolean
          title: Fatca Relevant
          description: '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_revenue:
          type: string
          format: number
          title: Expected Annual Revenue
          description: 'An estimate of the annual revenue.

            '
        currency:
          type: string
          maxLength: 3
          minLength: 3
          example: EUR
          title: Currency
          description: '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_identifier:
          type: string
          title: Legal Entity Identifier
          description: 'An ISO 17442 Legal Entity Identifier (LEI) assigned to the legal entity.

            '
        single_tier_ownership:
          type: boolean
          nullable: true
          title: Single Tier Ownership
          description: '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:
          $ref: '#/components/schemas/BusinessNFETypeEnum'
          type: object
          description: 'Nature of financial engagement (NFE) type associated with this business.

            '
      required:
      - id
      - name
      - registration
      - registered_address
      - taxation_countries
    BusinessIndustry:
      properties:
        nace_rev:
          $ref: '#/components/schemas/BusinessIndustryNaceRev'
        code:
          oneOf:
          - $ref: '#/components/schemas/BusinessIndustryCodeEnumTwo'
          - $ref: '#/components/schemas/BusinessIndustryCodeEnumTwoOne'
      type: object
      required:
      - nace_rev
      - code
      title: BusinessIndustry
      description: 'A specification of an industry sector.

        '
    BusinessDocumentType:
      type: string
      enum:
      - articles_of_association
      - commercial_register_extract
      - shareholder_list
      title: BusinessDocumentType
      description: 'A category describing the a business document:

        <ul> <li><code>articles_of_association</code> <li><code>commercial_register_extract</code> <li><code>shareholder_list</code> </ul>

        '
    ErrorResponse:
      title: ErrorResponse
      required:
      - message
      type: object
      properties:
        message:
          title: Message
          type: string
    BusinessDocumentUploadRequest:
      properties:
        document:
          $ref: '#/components/schemas/BusinessDocumentType'
      type: object
      required:
      - document
      title: BusinessDocumentUploadRequest
    EncodedPaginatedCollectionResponse_LegalRepresentativeResponse_:
      properties:
        data:
          items:
            $ref: '#/components/schemas/LegalRepresentativeResponse'
          type: array
          title: Data
          description: 'The elements of the response.

            '
        pagination:
          $ref: '#/components/schemas/EncodedPaginationResponse'
      type: object
      required:
      - data
      - pagination
      title: EncodedPaginatedCollectionResponse[LegalRepresentativeResponse]
    BusinessNFETypeEnum:
      type: string
      enum:
      - active
      - passive
      title: BusinessNFETypeEnum
      description: 'A category describing the business model of Non-Financial Entities (NFE):

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

        '
    BusinessRequest:
      type: object
      title: BusinessRequest
      description: Request object for creating a business record in the system.
      properties:
        name:
          type: string
          maxLength: 255
          minLength: 1
          title: Name
          description: The legal name of the business as formally registered.
          example: Wayne Enterprises, Inc.
        registration:
          $ref: '#/components/schemas/BusinessRegistrationRequest'
        industry:
          $ref: '#/components/schemas/IndustryRequest'
        registered_address:
          $ref: '#/components/schemas/AddressRequest'
        taxation_countries:
          type: array
          items:
            $ref: '#/components/schemas/BusinessTaxResidencyRequest'
          minItems: 1
          title: Taxation Countries
          description: 'A **complete** list of all tax residencies. It is critical that this list is exhaustive.

            '
        fatca_relevant:
          type: boolean
          title: Fatca Relevant
          description: '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_revenue:
          exclusiveMinimum: 0
          type: string
          format: number
          title: Expected Annual Revenue
          description: 'An estimate of the annual revenue of the business.

            '
        currency:
          type: string
          maxLength: 3
          minLength: 3
          example: EUR
          title: Currency
          description: 'A

# --- truncated at 32 KB (69 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/lemonmarkets/refs/heads/main/openapi/lemonmarkets-businesses-api-openapi.yml