> ## 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. # Add/Update Business Information > Add or update the KYC (Know Your Business) information for a business subaccount. This endpoint allows you to submit comprehensive business details including legal information, addresses, beneficial ownership, and supporting documents required for business verification. ## OpenAPI ````yaml /api-reference/openapi.json patch /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}: patch: tags: - Verification summary: Add/Update Business Information description: >- Add or update the KYC (Know Your Business) information for a business subaccount. This endpoint allows you to submit comprehensive business details including legal information, addresses, beneficial ownership, and supporting documents required for business 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 properties: legal_name: type: string description: The official registered legal name of the business entity trade_name: type: string description: >- The trading name or brand name used by the business (also known as DBA - Doing Business As) tax_number: type: string description: The primary tax identification number of the business registration_number: type: string description: >- The business registration or incorporation number issued by the registering authority incorporation_date: type: string format: date description: >- The date when the business was officially incorporated or registered (format: YYYY-MM-DD) description: type: string description: >- A detailed description of the business activities, products, and services email: type: string format: email description: The primary contact email address for the business source_of_funds: type: string description: >- The primary source from which the business receives its funds 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 description: The legal structure or type of the business entity enum: - cooperative - corporation - llc - other - partnership - sole_prop - trust website: type: string format: uri description: The business website URL registered_address: type: object description: >- The official registered address of the business as filed with government authorities properties: street_line_1: type: string description: Primary street address line street_line_2: type: string description: >- Secondary street address line (suite, floor, building, etc.) city: type: string description: City or town name 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 description: >- The actual physical location where the business operates (may differ from registered address) properties: street_line_1: type: string description: Primary street address line street_line_2: type: string description: >- Secondary street address line (suite, floor, building, etc.) city: type: string description: City or town name 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 description: >- Indicates whether the business is structured as a Decentralized Autonomous Organization (DAO) is_money_transmitter: type: boolean description: >- Indicates whether the business operates as a money services business or money transmitter 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 description: The primary intended use of the Bullring account 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 description: >- Array of individuals who ultimately own or control the business (typically those with 25% or more ownership or significant control) items: type: object properties: first_name: type: string description: First name of the beneficial owner middle_name: type: string description: Middle name of the beneficial owner last_name: type: string description: Last name of the beneficial owner birth_date: type: string format: date description: 'Date of birth (format: YYYY-MM-DD)' email: type: string format: email description: Email address of the beneficial owner nationality: type: string description: >- Two-letter ISO 3166-1 alpha-2 country code of the beneficial owner's nationality (e.g., "US" for United States) birth_country: type: string description: >- Two-letter ISO 3166-1 alpha-2 country code of the beneficial owner's country of birth (e.g., "CN" for China) address: type: object description: Residential address of the beneficial owner properties: street_line_1: type: string description: Primary street address line street_line_2: type: string description: >- Secondary street address line (apartment, unit, etc.) city: type: string description: City or town name 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 type of identification document enum: - passport - national_id - ssn number: type: string description: >- The identification document number. For SSN, must be exactly 9 digits without dashes (e.g., 123456789). issuing_country: type: string description: >- Two-letter ISO 3166-1 alpha-2 country code for the issuing country (e.g., "US" for United States) image_front: type: string format: uri description: >- URL of the front image of the identification document. Supported formats: jpeg, jpg, png, heic, heif, pdf image_back: type: string format: uri nullable: true description: >- URL of the back image of the identification document (if applicable). Supported formats: jpeg, jpg, png, heic, heif, pdf documents: type: array description: >- Array of additional supporting documents for the beneficial owner (e.g., proof of address) items: type: object properties: file: type: string format: uri description: URL of the document file purpose: type: string description: The purpose or type of document enum: - PROOF_OF_ADDRESS - BANK_STATEMENT - UTILITY_BILL - OTHER description: type: string description: A brief description of the document contents has_ownership: type: boolean description: >- Indicates whether this individual has ownership stake in the business ownership_percentage: type: string description: >- The percentage of ownership this individual holds in the business (e.g., "55.5" for 55.5%) has_control: type: boolean description: >- Indicates whether this individual has significant control or decision-making authority over the business is_signer: type: boolean description: >- Indicates whether this individual is an authorized signatory for the business title: type: string description: >- The job title or role of this individual within the business (e.g., "Chief Executive Officer", "Director") formation_document: type: string format: uri description: >- Certificate of Incorporation or similar document that proves the formation of the business. Supported document formats are jpeg, jpg, png, heic, heif, pdf ownership_document: type: string format: uri description: >- A document that proves the ownership structure of the business. Supported document formats are jpeg, jpg, png, heic, heif, pdf pattern: \.(jpeg|jpg|png|heic|heif|pdf)$ example: - share certificate - trust deed flow_of_funds_document: type: string format: uri nullable: true description: >- A document that proves the flow of funds for the business. Supported document formats are jpeg, jpg, png, heic, heif, pdf proof_of_address_document: type: string format: uri description: >- A document that proves the business address (e.g., utility bill, lease agreement, bank statement). Supported document formats are jpeg, jpg, png, heic, heif, pdf has_material_intermediary_ownership: type: boolean description: >- Indicates whether any intermediary entities (e.g., holding companies, trusts) have material ownership in the business expected_monthly_volume_usd: type: string description: >- The expected monthly transaction volume in USD (numeric string) source_of_funds_description: type: string description: >- A detailed description of how the business generates its funds and revenue streams acting_as_intermediary: type: boolean description: >- Indicates whether the business acts as an intermediary or facilitator for third-party transactions example: legal_name: Acme33 Technology Corporation trade_name: Acme Tech tax_number: 987-65-4321 registration_number: CR-2024-001234 incorporation_date: '2020-06-15' description: >- Leading provider of innovative technology solutions including software development, cloud services, and digital transformation consulting for enterprise clients email: contact@acmetech.com website: https://www.acmetech.com source_of_funds: sales_of_goods_and_services business_type: llc 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: USA 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-22' 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: '342730792' issuing_country: US image_front: >- https://res.cloudinary.com/bullring-finance/image/upload/v1774615329/1128061-Germany-ID_front_dfdcek.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: '55.5' has_control: true is_signer: true title: Chief Executive Officer - first_name: Michael middle_name: Alexander last_name: Chen birth_date: '1982-11-08' 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 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: '44.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 acting_as_intermediary: false responses: '200': description: Business information updated successfully content: application/json: schema: type: object properties: status: 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 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. 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 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-01-12T16:28:42.790Z' updated_at: '2026-01-12T16:28:42.825Z' 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: Bad Request - Invalid input data content: application/json: schema: type: object properties: statusCode: type: integer message: type: string timestamp: type: string format: date-time path: type: string error: type: string example: statusCode: 400 timestamp: '2026-04-22T16:23:53.640Z' path: /v1/kyc/businesses/57b97754-ab53-4e6a-9ff6-78bcb17e8460 error: Bad Request message: >- ultimate_beneficial_owners.1.identification.0.Social Security Number must be exactly 9 digits without dashes. Example: 123456789 components: securitySchemes: x-api-key: type: apiKey in: header name: x-api-key ````