> ## 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 Business Information > Retrieve the business KYC information. ## OpenAPI ````yaml /api-reference/openapi.json get /v1/kyc/businesses/{subaccountId} 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}: get: tags: - Verification summary: Get Business Information description: Retrieve the business KYC information. parameters: - name: subaccountId in: path schema: type: string format: uuid required: true description: The unique identifier of the subaccount responses: '200': description: Successful response 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 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 business tax identification documents. See [Business ID Numbers](http://localhost:3000/en/use-cases/business-id-numbers) for accepted document types. items: type: object properties: type: type: string description: >- The tax Identification document type. Eg "tin" for Nigeria Tax Identification Number, "ein" for US, "utr" for UK etc. number: type: string description: >- The tax identification number of the company. For EIN and SSN, must be exactly 9 digits without dashes (e.g., 123456789). 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 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 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: not_started created_at: '2026-03-31T11:51:15.876Z' updated_at: '2026-03-31T11:51:16.196Z' sumsubStatus: null sumsubApplicantId: 69cbb534b67b5d47f799e99a sumsubVerifiedAt: null type: business legal_name: Acme Technology Corporation registration_number: CR-2024-001234 incorporation_date: '2020-06-15' trade_name: Acme Tech description: >- Leading provider of innovative technology solutions including software development, cloud services, and digital transformation consulting for enterprise clients source_of_funds: sales_of_goods_and_services business_type: llc website: https://www.acmetech.com tax_number: 987-65-4321 acting_as_intermediary: false registered_address: street_line_1: 1234 Market Street street_line_2: Suite 500 city: San Francisco subdivision: CA postal_code: '94103' country: USA physical_address: street_line_1: 5678 Mission Boulevard street_line_2: Building A, Floor 3 city: San Francisco subdivision: CA postal_code: '94110' country: USA identification: - type: ein number: '123456789' issuing_country: DEU image_front: >- https://res.cloudinary.com/bullring-finance/image/upload/v1774564645/kyc/customers/070e5803-a6cc-4290-96d8-bed3c7084b84/sumsub_69c5b51632aa86f6ed120536_855161797.jpg image_back: null is_dao: false is_money_transmitter: false business_industry: - '523999' - '541511' - '518210' account_purpose: receive_payments_for_goods_and_services ultimate_beneficial_owners: - first_name: Sarah middle_name: Elizabeth last_name: Johnson birth_date: '1985-03-22T00:00:00.000Z' email: sarah.johnson@acmetech.com nationality: US birth_country: US address: street_line_1: 789 Oak Avenue street_line_2: Apartment 12 city: Palo Alto subdivision: CA postal_code: '94301' country: USA identification: - type: ssn number: D1234567 issuing_country: US image_front: >- https://res.cloudinary.com/bullring-finance/image/upload/v1774615329/1128061-Germany-ID_front_dfdcek.png image_back: >- https://res.cloudinary.com/bullring-finance/image/upload/v1774615329/012e6a1-Germany-ID_back_mz3ebe.png documents: - file: >- https://res.cloudinary.com/bullring-finance/image/upload/v1774564646/kyc/customers/070e5803-a6cc-4290-96d8-bed3c7084b84/sumsub_69c5b51632aa86f6ed120536_1362390373.jpg purpose: PROOF_OF_ADDRESS description: Recent utility bill showing residential address has_ownership: true ownership_percentage: '65.5' has_control: true is_signer: true title: Chief Executive Officer - first_name: Michael middle_name: Alexander last_name: Chen birth_date: '1982-11-08T00:00:00.000Z' email: michael.chen@acmetech.com nationality: US birth_country: CN address: street_line_1: 456 Pine Street city: Mountain View subdivision: CA postal_code: '94040' country: USA identification: - type: ssn number: '322730792' issuing_country: US image_front: >- https://res.cloudinary.com/bullring-finance/image/upload/v1774564645/kyc/customers/070e5803-a6cc-4290-96d8-bed3c7084b84/sumsub_69c5b51632aa86f6ed120536_855161797.jpg documents: - file: >- https://res.cloudinary.com/bullring-finance/image/upload/v1774564646/kyc/customers/070e5803-a6cc-4290-96d8-bed3c7084b84/sumsub_69c5b51632aa86f6ed120536_1362390373.jpg purpose: PROOF_OF_ADDRESS description: Recent utility bill showing residential address has_ownership: true ownership_percentage: '34.5' has_control: false is_signer: true title: Chief Technology Officer formation_document: >- https://res.cloudinary.com/dgqsur6xy/image/upload/v1708994045/samples/cup-on-a-table.jpg ownership_document: >- https://res.cloudinary.com/dgqsur6xy/image/upload/v1708994045/samples/cup-on-a-table.jpg flow_of_funds_document: >- https://res.cloudinary.com/dgqsur6xy/image/upload/v1708994045/samples/cup-on-a-table.jpg proof_of_address_document: >- https://res.cloudinary.com/dgqsur6xy/image/upload/v1708994045/samples/cup-on-a-table.jpg has_material_intermediary_ownership: false expected_monthly_volume_usd: '250000' source_of_funds_description: >- Primary revenue generated through enterprise software licensing agreements, recurring SaaS subscriptions, professional consulting services, and technology implementation projects for Fortune 500 clients sumsub_share_kyc_token: e documents: - purpose: business_formation file: >- https://res.cloudinary.com/dgqsur6xy/image/upload/v1708994045/samples/cup-on-a-table.jpg description: Business formation document - purpose: shareholder_registry file: >- https://res.cloudinary.com/dgqsur6xy/image/upload/v1708994045/samples/cup-on-a-table.jpg description: Shareholder/ownership registry - purpose: PROOF_OF_ADDRESS file: >- https://res.cloudinary.com/dgqsur6xy/image/upload/v1708994045/samples/cup-on-a-table.jpg description: Proof of business address '404': description: Business not found content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: statusCode: 404 timestamp: '2026-01-12T16:03:41.899Z' error: Error message: Business not found 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 ````