> ## 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 Individual Information

> Submit the customer information for verification.



## OpenAPI

````yaml /api-reference/openapi.json post /v1/kyc/customers/{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/customers/{subaccountId}/submit:
    post:
      tags:
        - Verification
      summary: Submit Individual Information
      description: Submit the customer 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
                  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
                  first_name:
                    type: string
                  middle_name:
                    type: string
                    nullable: true
                  last_name:
                    type: string
                  phone:
                    type: string
                    description: >-
                      Phone number of the customer. Must be in E.164 format
                      (e.g., +2348012345678)
                  address:
                    type: object
                    properties:
                      street_line_1:
                        type: string
                      street_line_2:
                        type: string
                      city:
                        type: string
                      state:
                        type: string
                      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)
                  birth_date:
                    type: string
                    format: date
                  documents:
                    type: array
                    items:
                      type: object
                      properties:
                        purpose:
                          type: string
                          enum:
                            - PROOF_OF_ACCOUNT_PURPOSE
                            - PROOF_OF_ADDRESS
                            - PROOF_OF_SOURCE_OF_FUNDS
                          description: Proof of address is required
                        file:
                          type: string
                          format: uri
                          description: >-
                            Supported document formats are jpeg, jpg, png, heic,
                            heif, pdf
                  account_purpose:
                    type: string
                  account_purpose_other:
                    type: string
                    nullable: true
                  employment_status:
                    type: string
                  expected_monthly_payments_usd:
                    type: string
                  acting_as_intermediary:
                    type: boolean
                  most_recent_occupation:
                    type: string
                    description: >-
                      Fetch from occupation endpoint:
                      [/api-reference/verification/get-occupations](/api-reference/verification/get-occupations)
                  source_of_funds:
                    type: string
                    enum:
                      - company_funds
                      - ecommerce_reseller
                      - gambling_proceeds
                      - gifts
                      - government_benefits
                      - inheritance
                      - investments_loans
                      - pension_retirement
                      - salary
                      - sale_of_assets_real_estate
                      - savings
                      - someone_elses_funds
                  source_of_funds_description:
                    type: string
                  identifying_information:
                    type: array
                    description: >-
                      Array of identification documents. See [Accepted ID
                      Documents by Country](/en/use-cases/individual-id-numbers)
                      for country-specific requirements.
                    items:
                      type: object
                      properties:
                        type:
                          type: string
                          enum:
                            - matriculate_id
                            - military_id
                            - national_id
                            - passport
                            - permanent_residency_id
                            - state_or_provincial_id
                            - visa
                        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)
                        number:
                          type: string
                        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
              example:
                status: incomplete
                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: '2025-12-31T10:37:53.156Z'
                updated_at: '2025-12-31T10:38:25.087Z'
                type: individual
                first_name: Mike
                middle_name: null
                last_name: Bull
                phone: '+2348012345678'
                address:
                  street_line_1: 9 Karimu Street
                  street_line_2: ''
                  city: Lagos
                  state: LA
                  postal_code: '105102'
                  country: NGA
                birth_date: '1993-01-24'
                documents:
                  - purpose: PROOF_OF_ADDRESS
                    file: >-
                      https://res.cloudinary.com/bullring-finance/image/upload/v1763738205/verification/2025-11-21/n0slzbkhxreppmqew4yd.png
                account_purpose: payments_to_friends_or_family_abroad
                account_purpose_other: null
                employment_status: employed
                expected_monthly_payments_usd: FROM_5000_TO_9999
                acting_as_intermediary: false
                most_recent_occupation: ACCOUNTANT_AND_AUDITOR
                source_of_funds: inheritance
                identifying_information:
                  - type: passport
                    issuing_country: NGA
                    number: '12345678909'
                    image_front: >-
                      https://res.cloudinary.com/bullring-finance/image/upload/v1763738198/verification/2025-11-21/t2fgqlxesqigmm0qfvbi.png
                    image_back: >-
                      https://res.cloudinary.com/bullring-finance/image/upload/v1763738205/verification/2025-11-21/n0slzbkhxreppmqew4yd.png
        '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

````