> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bullring.finance/llms.txt
> Use this file to discover all available pages before exploring further.

# Submit Business Information

> Submit the business information for verification.



## OpenAPI

````yaml /api-reference/openapi.json post /v1/kyc/businesses/{subaccountId}/submit
openapi: 3.0.0
info:
  title: Bullring Finance API
  description: >-
    The Bullring Finance API allows you to build powerful cross-border payment
    solutions.
  version: 1.0.0
servers:
  - url: https://api.bullring.finance
    description: Production Server
  - url: https://staging-api.bullring.finance
    description: Sandbox Server
security:
  - x-api-key: []
tags:
  - name: Subaccounts
    description: Operations related to user subaccounts.
  - name: Verification
    description: Endpoints for subaccount verification, including KYC and KYB processes.
  - name: Balances
    description: Endpoints for retrieving account balances.
  - name: Deposits
    description: Endpoints for handling deposits into subaccounts.
  - name: Recipients
    description: Manage payment recipients for withdrawals.
  - name: Withdrawals
    description: Endpoints for handling withdrawals from subaccounts.
  - name: Conversions
    description: Endpoints for currency conversions.
  - name: Rates
    description: Endpoints for currency conversion rates.
  - name: Fees
    description: Endpoints for checking transaction fees.
  - name: Offramp
    description: Endpoints for handling offramp operations.
  - name: Onramp
    description: Endpoints for handling onramp operations.
paths:
  /v1/kyc/businesses/{subaccountId}/submit:
    post:
      tags:
        - Verification
      summary: Submit Business Information
      description: Submit the business information for verification.
      parameters:
        - name: subaccountId
          in: path
          schema:
            type: string
            format: uuid
          required: true
          description: The unique identifier of the subaccount
      requestBody:
        content:
          application/json:
            schema:
              type: object
            example: {}
      responses:
        '200':
          description: Submission successful
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                  email:
                    type: string
                    format: email
                  rejection_reasons:
                    type: array
                    items:
                      type: string
                  endorsements:
                    type: array
                    items:
                      type: object
                      properties:
                        name:
                          type: string
                        status:
                          type: string
                        additional_requirements:
                          type: array
                          items:
                            type: string
                  created_at:
                    type: string
                    format: date-time
                  updated_at:
                    type: string
                    format: date-time
                  type:
                    type: string
                  legal_name:
                    type: string
                  trade_name:
                    type: string
                  description:
                    type: string
                  source_of_funds:
                    type: string
                    enum:
                      - business_loans
                      - grants
                      - inter_company_funds
                      - investment_proceeds
                      - legal_settlement
                      - owners_capital
                      - pension_retirement
                      - sale_of_assets
                      - sales_of_goods_and_services
                      - tax_refund
                      - third_party_funds
                      - treasury_reserves
                  business_type:
                    type: string
                    enum:
                      - cooperative
                      - corporation
                      - llc
                      - other
                      - partnership
                      - sole_prop
                      - trust
                  website:
                    type: string
                  registered_address:
                    type: object
                    properties:
                      street_line_1:
                        type: string
                      street_line_2:
                        type: string
                      city:
                        type: string
                      subdivision:
                        type: string
                        description: >-
                          two-letter ISO 3166-2 code for the state/province
                          (e.g., "LA" for Lagos, Nigeria) See [ISO
                          3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)
                      postal_code:
                        type: string
                      country:
                        type: string
                        description: >-
                          three-letter ISO 3166-1 code for the country (e.g.,
                          "NGA" for Nigeria). See [ISO
                          3166-1](https://en.wikipedia.org/wiki/ISO_3166-1)
                  physical_address:
                    type: object
                    properties:
                      street_line_1:
                        type: string
                      street_line_2:
                        type: string
                      city:
                        type: string
                      subdivision:
                        type: string
                        description: >-
                          two-letter ISO 3166-2 code for the state/province
                          (e.g., "LA" for Lagos, Nigeria) See [ISO
                          3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)
                      postal_code:
                        type: string
                      country:
                        type: string
                        description: >-
                          three-letter ISO 3166-1 code for the country (e.g.,
                          "NGA" for Nigeria). See [ISO
                          3166-1](https://en.wikipedia.org/wiki/ISO_3166-1)
                  identification:
                    type: array
                    description: >-
                      Array of identification documents for the beneficial
                      owner. See [Individual ID
                      Numbers](http://localhost:3000/en/use-cases/individual-id-numbers)
                      for accepted document types.
                    items:
                      type: object
                      properties:
                        type:
                          type: string
                          description: The passport of the individual.
                          enum:
                            - passport
                        number:
                          type: string
                          description: The passport number of the individual.
                        issuing_country:
                          type: string
                          description: >-
                            three-letter ISO 3166-1 code for the country (e.g.,
                            "NGA" for Nigeria). See [ISO
                            3166-1](https://en.wikipedia.org/wiki/ISO_3166-1)
                        image_front:
                          type: string
                          format: uri
                          description: >-
                            Supported document formats are jpeg, jpg, png, heic,
                            heif, pdf
                        image_back:
                          type: string
                          format: uri
                          description: >-
                            Supported document formats are jpeg, jpg, png, heic,
                            heif, pdf
                  is_dao:
                    type: boolean
                  is_money_transmitter:
                    type: boolean
                  business_industry:
                    type: array
                    items:
                      type: string
                    description: >-
                      Array of Industry codes of the industry or industries the
                      business operates in. The can be gotten here [Industry
                      Codes](https://api.bullring.finance/v1/kyc/industry-codes)
                  account_purpose:
                    type: string
                    enum:
                      - charitable_donations
                      - ecommerce_retail_payments
                      - investment_purposes
                      - other
                      - payments_to_friends_or_family_abroad
                      - payroll
                      - personal_or_living_expenses
                      - protect_wealth
                      - purchase_goods_and_services
                      - receive_payments_for_goods_and_services
                      - tax_optimization
                      - third_party_money_transmission
                      - treasury_management
                  ultimate_beneficial_owners:
                    type: array
                    items:
                      type: object
                      properties:
                        first_name:
                          type: string
                        middle_name:
                          type: string
                        last_name:
                          type: string
                        birth_date:
                          type: string
                          format: date-time
                        email:
                          type: string
                          format: email
                        address:
                          type: object
                          properties:
                            street_line_1:
                              type: string
                            street_line_2:
                              type: string
                            city:
                              type: string
                            subdivision:
                              type: string
                              description: >-
                                two-letter ISO 3166-2 code for the
                                state/province (e.g., "LA" for Lagos, Nigeria)
                                See [ISO
                                3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)
                            postal_code:
                              type: string
                            country:
                              type: string
                              description: >-
                                three-letter ISO 3166-1 code for the country
                                (e.g., "NGA" for Nigeria). See [ISO
                                3166-1](https://en.wikipedia.org/wiki/ISO_3166-1)
                        identification:
                          type: array
                          items:
                            type: object
                            properties:
                              type:
                                type: string
                                description: The passport number of the individual.
                                enum:
                                  - passport
                              number:
                                type: string
                                description: The passport number of the individual.
                              issuing_country:
                                type: string
                                description: >-
                                  three-letter ISO 3166-1 code for the country
                                  (e.g., "NGA" for Nigeria). See [ISO
                                  3166-1](https://en.wikipedia.org/wiki/ISO_3166-1)
                              image_front:
                                type: string
                                format: uri
                                description: >-
                                  Supported document formats are jpeg, jpg, png,
                                  heic, heif, pdf
                              image_back:
                                type: string
                                format: uri
                                description: >-
                                  Supported document formats are jpeg, jpg, png,
                                  heic, heif, pdf
                        has_ownership:
                          type: boolean
                        has_control:
                          type: boolean
                        is_signer:
                          type: boolean
                        title:
                          type: string
                  formation_document:
                    type: string
                    format: uri
                    description: >-
                      Supported document formats are jpeg, jpg, png, heic, heif,
                      pdf
                  ownership_document:
                    type: string
                    format: uri
                    description: >-
                      Supported document formats are jpeg, jpg, png, heic, heif,
                      pdf
                  flow_of_funds_document:
                    type: string
                    format: uri
                    nullable: true
                    description: >-
                      Supported document formats are jpeg, jpg, png, heic, heif,
                      pdf
                  has_material_intermediary_ownership:
                    type: boolean
              example:
                status: awaiting_ubo
                email: johnanisere+15124@bullring.finance
                rejection_reasons: []
                endorsements:
                  - name: base
                    status: incomplete
                    additional_requirements:
                      - kyc_approval
                  - name: sepa
                    status: incomplete
                    additional_requirements:
                      - kyc_approval
                      - kyc_with_proof_of_address
                created_at: '2026-01-12T16:28:42.790Z'
                updated_at: '2026-01-12T16:30:46.020Z'
                type: business
                legal_name: Bullring Finance 2
                trade_name: Anisere
                description: yfguy bhbiu
                source_of_funds: grants
                business_type: corporation
                website: bullring.finance
                registered_address:
                  street_line_1: 1 Swallow Street
                  street_line_2: ''
                  city: birmingham
                  subdivision: EN
                  postal_code: B2 4AA
                  country: GBR
                physical_address:
                  street_line_1: 1 Swallow Street
                  street_line_2: ''
                  city: birmingham
                  subdivision: EN
                  postal_code: B2 4AA
                  country: GBR
                identification:
                  - type: crn
                    number: '1760716'
                    issuing_country: GBR
                    image_front: >-
                      https://res.cloudinary.com/bullring-finance/image/upload/v1768169867/verification/2026-01-11/ofq7atduwn1bwvtvxrb1.png
                    image_back: ''
                is_dao: false
                is_money_transmitter: false
                business_industry:
                  - '111150'
                account_purpose: payroll
                ultimate_beneficial_owners:
                  - first_name: John
                    middle_name: Omoniyi
                    last_name: Anisere
                    birth_date: '1993-10-05T00:00:00.000Z'
                    email: johnanisere@gmail.com
                    address:
                      street_line_1: 1 Swallow Street
                      street_line_2: ''
                      city: birmingham
                      subdivision: EN
                      postal_code: B2 4AA
                      country: GBR
                    identification:
                      - type: passport
                        number: B50091752
                        issuing_country: NGA
                        image_front: >-
                          https://res.cloudinary.com/bullring-finance/image/upload/v1768169918/verification/2026-01-11/mvwnlnpgvzrxuiyw0erl.png
                        image_back: ''
                    has_ownership: true
                    has_control: true
                    is_signer: true
                    title: CEO
                formation_document: >-
                  https://res.cloudinary.com/bullring-finance/image/upload/v1768169962/verification/2026-01-11/qxxtzbtflevi7ipxcfkg.png
                ownership_document: >-
                  https://res.cloudinary.com/bullring-finance/image/upload/v1768169966/verification/2026-01-11/vlidzev2rladftq7a1td.png
                flow_of_funds_document: null
                has_material_intermediary_ownership: false
        '400':
          description: Missing required fields
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                statusCode: 400
                timestamp: '2025-12-31T10:19:59.164Z'
                error: Error
                message: 'Missing required fields: signed_agreement_id'
components:
  schemas:
    ErrorResponse:
      type: object
      properties:
        statusCode:
          type: integer
        message:
          type: string
        timestamp:
          type: string
          format: date-time
        path:
          type: string
        error:
          type: string
  securitySchemes:
    x-api-key:
      type: apiKey
      in: header
      name: x-api-key

````