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

# Get Verification Form

> Get the Know Your Customer/Business verification form URL.



## OpenAPI

````yaml /api-reference/openapi.json post /v1/ramp/subaccount/{subaccountId}/verification
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/ramp/subaccount/{subaccountId}/verification:
    post:
      tags:
        - Verification
      summary: Get Verification Form
      description: Get the Know Your Customer/Business verification form URL.
      parameters:
        - name: subaccountId
          in: path
          schema:
            type: string
            format: uuid
            example: 6a0fd7af-181d-4c0f-b24b-b8cfb739d67a
          required: true
          description: The unique identifier of the subaccount
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                verificationType:
                  type: string
                  enum:
                    - individual
                    - business
                  description: Type of verification to perform
                  example: individual
              required:
                - verificationType
            example:
              verificationType: individual
      responses:
        '201':
          description: Verification process initiated successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  formUrl:
                    type: string
                    format: uri
                    description: >-
                      URL to the verification form where the user can complete
                      their KYB/KYC verification
                required:
                  - formUrl
              example:
                formUrl: https://in.sumsub.com/websdk/p/abc123xyz
        '401':
          description: Unauthorized - Invalid or missing API key
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  message:
                    type: string
              example:
                error: Unauthorized
                message: Invalid or missing API key
        '403':
          description: Forbidden - Insufficient permissions
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  message:
                    type: string
              example:
                error: Forbidden
                message: You do not have permission to access this resource
        '404':
          description: Not Found - Subaccount not found
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  message:
                    type: string
              example:
                error: Not Found
                message: Subaccount not found
components:
  securitySchemes:
    x-api-key:
      type: apiKey
      in: header
      name: x-api-key

````