Add/Update Business Information
curl --request PATCH \
--url https://api.bullring.finance/v1/kyc/businesses/{subaccountId} \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"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": "[email protected]",
"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": "[email protected]",
"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": "[email protected]",
"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
}
'import requests
url = "https://api.bullring.finance/v1/kyc/businesses/{subaccountId}"
payload = {
"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": "[email protected]",
"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": None
}
],
"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": "[email protected]",
"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": "[email protected]",
"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
}
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
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: '[email protected]',
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: '[email protected]',
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: '[email protected]',
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
})
};
fetch('https://api.bullring.finance/v1/kyc/businesses/{subaccountId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.bullring.finance/v1/kyc/businesses/{subaccountId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'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' => '[email protected]',
'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' => '[email protected]',
'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' => '[email protected]',
'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
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.bullring.finance/v1/kyc/businesses/{subaccountId}"
payload := strings.NewReader("{\n \"legal_name\": \"Acme33 Technology Corporation\",\n \"trade_name\": \"Acme Tech\",\n \"tax_number\": \"987-65-4321\",\n \"registration_number\": \"CR-2024-001234\",\n \"incorporation_date\": \"2020-06-15\",\n \"description\": \"Leading provider of innovative technology solutions including software development, cloud services, and digital transformation consulting for enterprise clients\",\n \"email\": \"[email protected]\",\n \"website\": \"https://www.acmetech.com\",\n \"source_of_funds\": \"sales_of_goods_and_services\",\n \"business_type\": \"llc\",\n \"registered_address\": {\n \"street_line_1\": \"1234 Market Street\",\n \"street_line_2\": \"Suite 500\",\n \"city\": \"San Francisco\",\n \"subdivision\": \"CA\",\n \"postal_code\": \"94103\",\n \"country\": \"USA\"\n },\n \"physical_address\": {\n \"street_line_1\": \"5678 Mission Boulevard\",\n \"street_line_2\": \"Building A, Floor 3\",\n \"city\": \"San Francisco\",\n \"subdivision\": \"CA\",\n \"postal_code\": \"94110\",\n \"country\": \"USA\"\n },\n \"identification\": [\n {\n \"type\": \"ein\",\n \"number\": \"123456789\",\n \"issuing_country\": \"USA\",\n \"image_front\": \"https://res.cloudinary.com/bullring-finance/image/upload/v1774564645/kyc/customers/070e5803-a6cc-4290-96d8-bed3c7084b84/sumsub_69c5b51632aa86f6ed120536_855161797.jpg\",\n \"image_back\": null\n }\n ],\n \"is_dao\": false,\n \"is_money_transmitter\": false,\n \"business_industry\": [\n \"523999\",\n \"541511\",\n \"518210\"\n ],\n \"account_purpose\": \"receive_payments_for_goods_and_services\",\n \"ultimate_beneficial_owners\": [\n {\n \"first_name\": \"Sarah\",\n \"middle_name\": \"Elizabeth\",\n \"last_name\": \"Johnson\",\n \"birth_date\": \"1985-03-22\",\n \"email\": \"[email protected]\",\n \"nationality\": \"US\",\n \"birth_country\": \"US\",\n \"address\": {\n \"street_line_1\": \"789 Oak Avenue\",\n \"street_line_2\": \"Apartment 12\",\n \"city\": \"Palo Alto\",\n \"subdivision\": \"CA\",\n \"postal_code\": \"94301\",\n \"country\": \"USA\"\n },\n \"identification\": [\n {\n \"type\": \"ssn\",\n \"number\": \"342730792\",\n \"issuing_country\": \"US\",\n \"image_front\": \"https://res.cloudinary.com/bullring-finance/image/upload/v1774615329/1128061-Germany-ID_front_dfdcek.png\"\n }\n ],\n \"documents\": [\n {\n \"file\": \"https://res.cloudinary.com/bullring-finance/image/upload/v1774564646/kyc/customers/070e5803-a6cc-4290-96d8-bed3c7084b84/sumsub_69c5b51632aa86f6ed120536_1362390373.jpg\",\n \"purpose\": \"PROOF_OF_ADDRESS\",\n \"description\": \"Recent utility bill showing residential address\"\n }\n ],\n \"has_ownership\": true,\n \"ownership_percentage\": \"55.5\",\n \"has_control\": true,\n \"is_signer\": true,\n \"title\": \"Chief Executive Officer\"\n },\n {\n \"first_name\": \"Michael\",\n \"middle_name\": \"Alexander\",\n \"last_name\": \"Chen\",\n \"birth_date\": \"1982-11-08\",\n \"email\": \"[email protected]\",\n \"nationality\": \"US\",\n \"birth_country\": \"CN\",\n \"address\": {\n \"street_line_1\": \"456 Pine Street\",\n \"city\": \"Mountain View\",\n \"subdivision\": \"CA\",\n \"postal_code\": \"94040\",\n \"country\": \"USA\"\n },\n \"identification\": [\n {\n \"type\": \"ssn\",\n \"number\": \"322730792\",\n \"issuing_country\": \"US\"\n }\n ],\n \"documents\": [\n {\n \"file\": \"https://res.cloudinary.com/bullring-finance/image/upload/v1774564646/kyc/customers/070e5803-a6cc-4290-96d8-bed3c7084b84/sumsub_69c5b51632aa86f6ed120536_1362390373.jpg\",\n \"purpose\": \"PROOF_OF_ADDRESS\",\n \"description\": \"Recent utility bill showing residential address\"\n }\n ],\n \"has_ownership\": true,\n \"ownership_percentage\": \"44.5\",\n \"has_control\": false,\n \"is_signer\": true,\n \"title\": \"Chief Technology Officer\"\n }\n ],\n \"formation_document\": \"https://res.cloudinary.com/dgqsur6xy/image/upload/v1708994045/samples/cup-on-a-table.jpg\",\n \"ownership_document\": \"https://res.cloudinary.com/dgqsur6xy/image/upload/v1708994045/samples/cup-on-a-table.jpg\",\n \"flow_of_funds_document\": \"https://res.cloudinary.com/dgqsur6xy/image/upload/v1708994045/samples/cup-on-a-table.jpg\",\n \"proof_of_address_document\": \"https://res.cloudinary.com/dgqsur6xy/image/upload/v1708994045/samples/cup-on-a-table.jpg\",\n \"has_material_intermediary_ownership\": false,\n \"expected_monthly_volume_usd\": \"250000\",\n \"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\",\n \"acting_as_intermediary\": false\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("x-api-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.patch("https://api.bullring.finance/v1/kyc/businesses/{subaccountId}")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"legal_name\": \"Acme33 Technology Corporation\",\n \"trade_name\": \"Acme Tech\",\n \"tax_number\": \"987-65-4321\",\n \"registration_number\": \"CR-2024-001234\",\n \"incorporation_date\": \"2020-06-15\",\n \"description\": \"Leading provider of innovative technology solutions including software development, cloud services, and digital transformation consulting for enterprise clients\",\n \"email\": \"[email protected]\",\n \"website\": \"https://www.acmetech.com\",\n \"source_of_funds\": \"sales_of_goods_and_services\",\n \"business_type\": \"llc\",\n \"registered_address\": {\n \"street_line_1\": \"1234 Market Street\",\n \"street_line_2\": \"Suite 500\",\n \"city\": \"San Francisco\",\n \"subdivision\": \"CA\",\n \"postal_code\": \"94103\",\n \"country\": \"USA\"\n },\n \"physical_address\": {\n \"street_line_1\": \"5678 Mission Boulevard\",\n \"street_line_2\": \"Building A, Floor 3\",\n \"city\": \"San Francisco\",\n \"subdivision\": \"CA\",\n \"postal_code\": \"94110\",\n \"country\": \"USA\"\n },\n \"identification\": [\n {\n \"type\": \"ein\",\n \"number\": \"123456789\",\n \"issuing_country\": \"USA\",\n \"image_front\": \"https://res.cloudinary.com/bullring-finance/image/upload/v1774564645/kyc/customers/070e5803-a6cc-4290-96d8-bed3c7084b84/sumsub_69c5b51632aa86f6ed120536_855161797.jpg\",\n \"image_back\": null\n }\n ],\n \"is_dao\": false,\n \"is_money_transmitter\": false,\n \"business_industry\": [\n \"523999\",\n \"541511\",\n \"518210\"\n ],\n \"account_purpose\": \"receive_payments_for_goods_and_services\",\n \"ultimate_beneficial_owners\": [\n {\n \"first_name\": \"Sarah\",\n \"middle_name\": \"Elizabeth\",\n \"last_name\": \"Johnson\",\n \"birth_date\": \"1985-03-22\",\n \"email\": \"[email protected]\",\n \"nationality\": \"US\",\n \"birth_country\": \"US\",\n \"address\": {\n \"street_line_1\": \"789 Oak Avenue\",\n \"street_line_2\": \"Apartment 12\",\n \"city\": \"Palo Alto\",\n \"subdivision\": \"CA\",\n \"postal_code\": \"94301\",\n \"country\": \"USA\"\n },\n \"identification\": [\n {\n \"type\": \"ssn\",\n \"number\": \"342730792\",\n \"issuing_country\": \"US\",\n \"image_front\": \"https://res.cloudinary.com/bullring-finance/image/upload/v1774615329/1128061-Germany-ID_front_dfdcek.png\"\n }\n ],\n \"documents\": [\n {\n \"file\": \"https://res.cloudinary.com/bullring-finance/image/upload/v1774564646/kyc/customers/070e5803-a6cc-4290-96d8-bed3c7084b84/sumsub_69c5b51632aa86f6ed120536_1362390373.jpg\",\n \"purpose\": \"PROOF_OF_ADDRESS\",\n \"description\": \"Recent utility bill showing residential address\"\n }\n ],\n \"has_ownership\": true,\n \"ownership_percentage\": \"55.5\",\n \"has_control\": true,\n \"is_signer\": true,\n \"title\": \"Chief Executive Officer\"\n },\n {\n \"first_name\": \"Michael\",\n \"middle_name\": \"Alexander\",\n \"last_name\": \"Chen\",\n \"birth_date\": \"1982-11-08\",\n \"email\": \"[email protected]\",\n \"nationality\": \"US\",\n \"birth_country\": \"CN\",\n \"address\": {\n \"street_line_1\": \"456 Pine Street\",\n \"city\": \"Mountain View\",\n \"subdivision\": \"CA\",\n \"postal_code\": \"94040\",\n \"country\": \"USA\"\n },\n \"identification\": [\n {\n \"type\": \"ssn\",\n \"number\": \"322730792\",\n \"issuing_country\": \"US\"\n }\n ],\n \"documents\": [\n {\n \"file\": \"https://res.cloudinary.com/bullring-finance/image/upload/v1774564646/kyc/customers/070e5803-a6cc-4290-96d8-bed3c7084b84/sumsub_69c5b51632aa86f6ed120536_1362390373.jpg\",\n \"purpose\": \"PROOF_OF_ADDRESS\",\n \"description\": \"Recent utility bill showing residential address\"\n }\n ],\n \"has_ownership\": true,\n \"ownership_percentage\": \"44.5\",\n \"has_control\": false,\n \"is_signer\": true,\n \"title\": \"Chief Technology Officer\"\n }\n ],\n \"formation_document\": \"https://res.cloudinary.com/dgqsur6xy/image/upload/v1708994045/samples/cup-on-a-table.jpg\",\n \"ownership_document\": \"https://res.cloudinary.com/dgqsur6xy/image/upload/v1708994045/samples/cup-on-a-table.jpg\",\n \"flow_of_funds_document\": \"https://res.cloudinary.com/dgqsur6xy/image/upload/v1708994045/samples/cup-on-a-table.jpg\",\n \"proof_of_address_document\": \"https://res.cloudinary.com/dgqsur6xy/image/upload/v1708994045/samples/cup-on-a-table.jpg\",\n \"has_material_intermediary_ownership\": false,\n \"expected_monthly_volume_usd\": \"250000\",\n \"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\",\n \"acting_as_intermediary\": false\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bullring.finance/v1/kyc/businesses/{subaccountId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"legal_name\": \"Acme33 Technology Corporation\",\n \"trade_name\": \"Acme Tech\",\n \"tax_number\": \"987-65-4321\",\n \"registration_number\": \"CR-2024-001234\",\n \"incorporation_date\": \"2020-06-15\",\n \"description\": \"Leading provider of innovative technology solutions including software development, cloud services, and digital transformation consulting for enterprise clients\",\n \"email\": \"[email protected]\",\n \"website\": \"https://www.acmetech.com\",\n \"source_of_funds\": \"sales_of_goods_and_services\",\n \"business_type\": \"llc\",\n \"registered_address\": {\n \"street_line_1\": \"1234 Market Street\",\n \"street_line_2\": \"Suite 500\",\n \"city\": \"San Francisco\",\n \"subdivision\": \"CA\",\n \"postal_code\": \"94103\",\n \"country\": \"USA\"\n },\n \"physical_address\": {\n \"street_line_1\": \"5678 Mission Boulevard\",\n \"street_line_2\": \"Building A, Floor 3\",\n \"city\": \"San Francisco\",\n \"subdivision\": \"CA\",\n \"postal_code\": \"94110\",\n \"country\": \"USA\"\n },\n \"identification\": [\n {\n \"type\": \"ein\",\n \"number\": \"123456789\",\n \"issuing_country\": \"USA\",\n \"image_front\": \"https://res.cloudinary.com/bullring-finance/image/upload/v1774564645/kyc/customers/070e5803-a6cc-4290-96d8-bed3c7084b84/sumsub_69c5b51632aa86f6ed120536_855161797.jpg\",\n \"image_back\": null\n }\n ],\n \"is_dao\": false,\n \"is_money_transmitter\": false,\n \"business_industry\": [\n \"523999\",\n \"541511\",\n \"518210\"\n ],\n \"account_purpose\": \"receive_payments_for_goods_and_services\",\n \"ultimate_beneficial_owners\": [\n {\n \"first_name\": \"Sarah\",\n \"middle_name\": \"Elizabeth\",\n \"last_name\": \"Johnson\",\n \"birth_date\": \"1985-03-22\",\n \"email\": \"[email protected]\",\n \"nationality\": \"US\",\n \"birth_country\": \"US\",\n \"address\": {\n \"street_line_1\": \"789 Oak Avenue\",\n \"street_line_2\": \"Apartment 12\",\n \"city\": \"Palo Alto\",\n \"subdivision\": \"CA\",\n \"postal_code\": \"94301\",\n \"country\": \"USA\"\n },\n \"identification\": [\n {\n \"type\": \"ssn\",\n \"number\": \"342730792\",\n \"issuing_country\": \"US\",\n \"image_front\": \"https://res.cloudinary.com/bullring-finance/image/upload/v1774615329/1128061-Germany-ID_front_dfdcek.png\"\n }\n ],\n \"documents\": [\n {\n \"file\": \"https://res.cloudinary.com/bullring-finance/image/upload/v1774564646/kyc/customers/070e5803-a6cc-4290-96d8-bed3c7084b84/sumsub_69c5b51632aa86f6ed120536_1362390373.jpg\",\n \"purpose\": \"PROOF_OF_ADDRESS\",\n \"description\": \"Recent utility bill showing residential address\"\n }\n ],\n \"has_ownership\": true,\n \"ownership_percentage\": \"55.5\",\n \"has_control\": true,\n \"is_signer\": true,\n \"title\": \"Chief Executive Officer\"\n },\n {\n \"first_name\": \"Michael\",\n \"middle_name\": \"Alexander\",\n \"last_name\": \"Chen\",\n \"birth_date\": \"1982-11-08\",\n \"email\": \"[email protected]\",\n \"nationality\": \"US\",\n \"birth_country\": \"CN\",\n \"address\": {\n \"street_line_1\": \"456 Pine Street\",\n \"city\": \"Mountain View\",\n \"subdivision\": \"CA\",\n \"postal_code\": \"94040\",\n \"country\": \"USA\"\n },\n \"identification\": [\n {\n \"type\": \"ssn\",\n \"number\": \"322730792\",\n \"issuing_country\": \"US\"\n }\n ],\n \"documents\": [\n {\n \"file\": \"https://res.cloudinary.com/bullring-finance/image/upload/v1774564646/kyc/customers/070e5803-a6cc-4290-96d8-bed3c7084b84/sumsub_69c5b51632aa86f6ed120536_1362390373.jpg\",\n \"purpose\": \"PROOF_OF_ADDRESS\",\n \"description\": \"Recent utility bill showing residential address\"\n }\n ],\n \"has_ownership\": true,\n \"ownership_percentage\": \"44.5\",\n \"has_control\": false,\n \"is_signer\": true,\n \"title\": \"Chief Technology Officer\"\n }\n ],\n \"formation_document\": \"https://res.cloudinary.com/dgqsur6xy/image/upload/v1708994045/samples/cup-on-a-table.jpg\",\n \"ownership_document\": \"https://res.cloudinary.com/dgqsur6xy/image/upload/v1708994045/samples/cup-on-a-table.jpg\",\n \"flow_of_funds_document\": \"https://res.cloudinary.com/dgqsur6xy/image/upload/v1708994045/samples/cup-on-a-table.jpg\",\n \"proof_of_address_document\": \"https://res.cloudinary.com/dgqsur6xy/image/upload/v1708994045/samples/cup-on-a-table.jpg\",\n \"has_material_intermediary_ownership\": false,\n \"expected_monthly_volume_usd\": \"250000\",\n \"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\",\n \"acting_as_intermediary\": false\n}"
response = http.request(request)
puts response.read_body{
"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": "[email protected]",
"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
}{
"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"
}Verification
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.
PATCH
/
v1
/
kyc
/
businesses
/
{subaccountId}
Add/Update Business Information
curl --request PATCH \
--url https://api.bullring.finance/v1/kyc/businesses/{subaccountId} \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"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": "[email protected]",
"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": "[email protected]",
"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": "[email protected]",
"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
}
'import requests
url = "https://api.bullring.finance/v1/kyc/businesses/{subaccountId}"
payload = {
"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": "[email protected]",
"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": None
}
],
"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": "[email protected]",
"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": "[email protected]",
"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
}
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
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: '[email protected]',
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: '[email protected]',
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: '[email protected]',
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
})
};
fetch('https://api.bullring.finance/v1/kyc/businesses/{subaccountId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.bullring.finance/v1/kyc/businesses/{subaccountId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'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' => '[email protected]',
'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' => '[email protected]',
'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' => '[email protected]',
'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
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.bullring.finance/v1/kyc/businesses/{subaccountId}"
payload := strings.NewReader("{\n \"legal_name\": \"Acme33 Technology Corporation\",\n \"trade_name\": \"Acme Tech\",\n \"tax_number\": \"987-65-4321\",\n \"registration_number\": \"CR-2024-001234\",\n \"incorporation_date\": \"2020-06-15\",\n \"description\": \"Leading provider of innovative technology solutions including software development, cloud services, and digital transformation consulting for enterprise clients\",\n \"email\": \"[email protected]\",\n \"website\": \"https://www.acmetech.com\",\n \"source_of_funds\": \"sales_of_goods_and_services\",\n \"business_type\": \"llc\",\n \"registered_address\": {\n \"street_line_1\": \"1234 Market Street\",\n \"street_line_2\": \"Suite 500\",\n \"city\": \"San Francisco\",\n \"subdivision\": \"CA\",\n \"postal_code\": \"94103\",\n \"country\": \"USA\"\n },\n \"physical_address\": {\n \"street_line_1\": \"5678 Mission Boulevard\",\n \"street_line_2\": \"Building A, Floor 3\",\n \"city\": \"San Francisco\",\n \"subdivision\": \"CA\",\n \"postal_code\": \"94110\",\n \"country\": \"USA\"\n },\n \"identification\": [\n {\n \"type\": \"ein\",\n \"number\": \"123456789\",\n \"issuing_country\": \"USA\",\n \"image_front\": \"https://res.cloudinary.com/bullring-finance/image/upload/v1774564645/kyc/customers/070e5803-a6cc-4290-96d8-bed3c7084b84/sumsub_69c5b51632aa86f6ed120536_855161797.jpg\",\n \"image_back\": null\n }\n ],\n \"is_dao\": false,\n \"is_money_transmitter\": false,\n \"business_industry\": [\n \"523999\",\n \"541511\",\n \"518210\"\n ],\n \"account_purpose\": \"receive_payments_for_goods_and_services\",\n \"ultimate_beneficial_owners\": [\n {\n \"first_name\": \"Sarah\",\n \"middle_name\": \"Elizabeth\",\n \"last_name\": \"Johnson\",\n \"birth_date\": \"1985-03-22\",\n \"email\": \"[email protected]\",\n \"nationality\": \"US\",\n \"birth_country\": \"US\",\n \"address\": {\n \"street_line_1\": \"789 Oak Avenue\",\n \"street_line_2\": \"Apartment 12\",\n \"city\": \"Palo Alto\",\n \"subdivision\": \"CA\",\n \"postal_code\": \"94301\",\n \"country\": \"USA\"\n },\n \"identification\": [\n {\n \"type\": \"ssn\",\n \"number\": \"342730792\",\n \"issuing_country\": \"US\",\n \"image_front\": \"https://res.cloudinary.com/bullring-finance/image/upload/v1774615329/1128061-Germany-ID_front_dfdcek.png\"\n }\n ],\n \"documents\": [\n {\n \"file\": \"https://res.cloudinary.com/bullring-finance/image/upload/v1774564646/kyc/customers/070e5803-a6cc-4290-96d8-bed3c7084b84/sumsub_69c5b51632aa86f6ed120536_1362390373.jpg\",\n \"purpose\": \"PROOF_OF_ADDRESS\",\n \"description\": \"Recent utility bill showing residential address\"\n }\n ],\n \"has_ownership\": true,\n \"ownership_percentage\": \"55.5\",\n \"has_control\": true,\n \"is_signer\": true,\n \"title\": \"Chief Executive Officer\"\n },\n {\n \"first_name\": \"Michael\",\n \"middle_name\": \"Alexander\",\n \"last_name\": \"Chen\",\n \"birth_date\": \"1982-11-08\",\n \"email\": \"[email protected]\",\n \"nationality\": \"US\",\n \"birth_country\": \"CN\",\n \"address\": {\n \"street_line_1\": \"456 Pine Street\",\n \"city\": \"Mountain View\",\n \"subdivision\": \"CA\",\n \"postal_code\": \"94040\",\n \"country\": \"USA\"\n },\n \"identification\": [\n {\n \"type\": \"ssn\",\n \"number\": \"322730792\",\n \"issuing_country\": \"US\"\n }\n ],\n \"documents\": [\n {\n \"file\": \"https://res.cloudinary.com/bullring-finance/image/upload/v1774564646/kyc/customers/070e5803-a6cc-4290-96d8-bed3c7084b84/sumsub_69c5b51632aa86f6ed120536_1362390373.jpg\",\n \"purpose\": \"PROOF_OF_ADDRESS\",\n \"description\": \"Recent utility bill showing residential address\"\n }\n ],\n \"has_ownership\": true,\n \"ownership_percentage\": \"44.5\",\n \"has_control\": false,\n \"is_signer\": true,\n \"title\": \"Chief Technology Officer\"\n }\n ],\n \"formation_document\": \"https://res.cloudinary.com/dgqsur6xy/image/upload/v1708994045/samples/cup-on-a-table.jpg\",\n \"ownership_document\": \"https://res.cloudinary.com/dgqsur6xy/image/upload/v1708994045/samples/cup-on-a-table.jpg\",\n \"flow_of_funds_document\": \"https://res.cloudinary.com/dgqsur6xy/image/upload/v1708994045/samples/cup-on-a-table.jpg\",\n \"proof_of_address_document\": \"https://res.cloudinary.com/dgqsur6xy/image/upload/v1708994045/samples/cup-on-a-table.jpg\",\n \"has_material_intermediary_ownership\": false,\n \"expected_monthly_volume_usd\": \"250000\",\n \"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\",\n \"acting_as_intermediary\": false\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("x-api-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.patch("https://api.bullring.finance/v1/kyc/businesses/{subaccountId}")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"legal_name\": \"Acme33 Technology Corporation\",\n \"trade_name\": \"Acme Tech\",\n \"tax_number\": \"987-65-4321\",\n \"registration_number\": \"CR-2024-001234\",\n \"incorporation_date\": \"2020-06-15\",\n \"description\": \"Leading provider of innovative technology solutions including software development, cloud services, and digital transformation consulting for enterprise clients\",\n \"email\": \"[email protected]\",\n \"website\": \"https://www.acmetech.com\",\n \"source_of_funds\": \"sales_of_goods_and_services\",\n \"business_type\": \"llc\",\n \"registered_address\": {\n \"street_line_1\": \"1234 Market Street\",\n \"street_line_2\": \"Suite 500\",\n \"city\": \"San Francisco\",\n \"subdivision\": \"CA\",\n \"postal_code\": \"94103\",\n \"country\": \"USA\"\n },\n \"physical_address\": {\n \"street_line_1\": \"5678 Mission Boulevard\",\n \"street_line_2\": \"Building A, Floor 3\",\n \"city\": \"San Francisco\",\n \"subdivision\": \"CA\",\n \"postal_code\": \"94110\",\n \"country\": \"USA\"\n },\n \"identification\": [\n {\n \"type\": \"ein\",\n \"number\": \"123456789\",\n \"issuing_country\": \"USA\",\n \"image_front\": \"https://res.cloudinary.com/bullring-finance/image/upload/v1774564645/kyc/customers/070e5803-a6cc-4290-96d8-bed3c7084b84/sumsub_69c5b51632aa86f6ed120536_855161797.jpg\",\n \"image_back\": null\n }\n ],\n \"is_dao\": false,\n \"is_money_transmitter\": false,\n \"business_industry\": [\n \"523999\",\n \"541511\",\n \"518210\"\n ],\n \"account_purpose\": \"receive_payments_for_goods_and_services\",\n \"ultimate_beneficial_owners\": [\n {\n \"first_name\": \"Sarah\",\n \"middle_name\": \"Elizabeth\",\n \"last_name\": \"Johnson\",\n \"birth_date\": \"1985-03-22\",\n \"email\": \"[email protected]\",\n \"nationality\": \"US\",\n \"birth_country\": \"US\",\n \"address\": {\n \"street_line_1\": \"789 Oak Avenue\",\n \"street_line_2\": \"Apartment 12\",\n \"city\": \"Palo Alto\",\n \"subdivision\": \"CA\",\n \"postal_code\": \"94301\",\n \"country\": \"USA\"\n },\n \"identification\": [\n {\n \"type\": \"ssn\",\n \"number\": \"342730792\",\n \"issuing_country\": \"US\",\n \"image_front\": \"https://res.cloudinary.com/bullring-finance/image/upload/v1774615329/1128061-Germany-ID_front_dfdcek.png\"\n }\n ],\n \"documents\": [\n {\n \"file\": \"https://res.cloudinary.com/bullring-finance/image/upload/v1774564646/kyc/customers/070e5803-a6cc-4290-96d8-bed3c7084b84/sumsub_69c5b51632aa86f6ed120536_1362390373.jpg\",\n \"purpose\": \"PROOF_OF_ADDRESS\",\n \"description\": \"Recent utility bill showing residential address\"\n }\n ],\n \"has_ownership\": true,\n \"ownership_percentage\": \"55.5\",\n \"has_control\": true,\n \"is_signer\": true,\n \"title\": \"Chief Executive Officer\"\n },\n {\n \"first_name\": \"Michael\",\n \"middle_name\": \"Alexander\",\n \"last_name\": \"Chen\",\n \"birth_date\": \"1982-11-08\",\n \"email\": \"[email protected]\",\n \"nationality\": \"US\",\n \"birth_country\": \"CN\",\n \"address\": {\n \"street_line_1\": \"456 Pine Street\",\n \"city\": \"Mountain View\",\n \"subdivision\": \"CA\",\n \"postal_code\": \"94040\",\n \"country\": \"USA\"\n },\n \"identification\": [\n {\n \"type\": \"ssn\",\n \"number\": \"322730792\",\n \"issuing_country\": \"US\"\n }\n ],\n \"documents\": [\n {\n \"file\": \"https://res.cloudinary.com/bullring-finance/image/upload/v1774564646/kyc/customers/070e5803-a6cc-4290-96d8-bed3c7084b84/sumsub_69c5b51632aa86f6ed120536_1362390373.jpg\",\n \"purpose\": \"PROOF_OF_ADDRESS\",\n \"description\": \"Recent utility bill showing residential address\"\n }\n ],\n \"has_ownership\": true,\n \"ownership_percentage\": \"44.5\",\n \"has_control\": false,\n \"is_signer\": true,\n \"title\": \"Chief Technology Officer\"\n }\n ],\n \"formation_document\": \"https://res.cloudinary.com/dgqsur6xy/image/upload/v1708994045/samples/cup-on-a-table.jpg\",\n \"ownership_document\": \"https://res.cloudinary.com/dgqsur6xy/image/upload/v1708994045/samples/cup-on-a-table.jpg\",\n \"flow_of_funds_document\": \"https://res.cloudinary.com/dgqsur6xy/image/upload/v1708994045/samples/cup-on-a-table.jpg\",\n \"proof_of_address_document\": \"https://res.cloudinary.com/dgqsur6xy/image/upload/v1708994045/samples/cup-on-a-table.jpg\",\n \"has_material_intermediary_ownership\": false,\n \"expected_monthly_volume_usd\": \"250000\",\n \"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\",\n \"acting_as_intermediary\": false\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bullring.finance/v1/kyc/businesses/{subaccountId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"legal_name\": \"Acme33 Technology Corporation\",\n \"trade_name\": \"Acme Tech\",\n \"tax_number\": \"987-65-4321\",\n \"registration_number\": \"CR-2024-001234\",\n \"incorporation_date\": \"2020-06-15\",\n \"description\": \"Leading provider of innovative technology solutions including software development, cloud services, and digital transformation consulting for enterprise clients\",\n \"email\": \"[email protected]\",\n \"website\": \"https://www.acmetech.com\",\n \"source_of_funds\": \"sales_of_goods_and_services\",\n \"business_type\": \"llc\",\n \"registered_address\": {\n \"street_line_1\": \"1234 Market Street\",\n \"street_line_2\": \"Suite 500\",\n \"city\": \"San Francisco\",\n \"subdivision\": \"CA\",\n \"postal_code\": \"94103\",\n \"country\": \"USA\"\n },\n \"physical_address\": {\n \"street_line_1\": \"5678 Mission Boulevard\",\n \"street_line_2\": \"Building A, Floor 3\",\n \"city\": \"San Francisco\",\n \"subdivision\": \"CA\",\n \"postal_code\": \"94110\",\n \"country\": \"USA\"\n },\n \"identification\": [\n {\n \"type\": \"ein\",\n \"number\": \"123456789\",\n \"issuing_country\": \"USA\",\n \"image_front\": \"https://res.cloudinary.com/bullring-finance/image/upload/v1774564645/kyc/customers/070e5803-a6cc-4290-96d8-bed3c7084b84/sumsub_69c5b51632aa86f6ed120536_855161797.jpg\",\n \"image_back\": null\n }\n ],\n \"is_dao\": false,\n \"is_money_transmitter\": false,\n \"business_industry\": [\n \"523999\",\n \"541511\",\n \"518210\"\n ],\n \"account_purpose\": \"receive_payments_for_goods_and_services\",\n \"ultimate_beneficial_owners\": [\n {\n \"first_name\": \"Sarah\",\n \"middle_name\": \"Elizabeth\",\n \"last_name\": \"Johnson\",\n \"birth_date\": \"1985-03-22\",\n \"email\": \"[email protected]\",\n \"nationality\": \"US\",\n \"birth_country\": \"US\",\n \"address\": {\n \"street_line_1\": \"789 Oak Avenue\",\n \"street_line_2\": \"Apartment 12\",\n \"city\": \"Palo Alto\",\n \"subdivision\": \"CA\",\n \"postal_code\": \"94301\",\n \"country\": \"USA\"\n },\n \"identification\": [\n {\n \"type\": \"ssn\",\n \"number\": \"342730792\",\n \"issuing_country\": \"US\",\n \"image_front\": \"https://res.cloudinary.com/bullring-finance/image/upload/v1774615329/1128061-Germany-ID_front_dfdcek.png\"\n }\n ],\n \"documents\": [\n {\n \"file\": \"https://res.cloudinary.com/bullring-finance/image/upload/v1774564646/kyc/customers/070e5803-a6cc-4290-96d8-bed3c7084b84/sumsub_69c5b51632aa86f6ed120536_1362390373.jpg\",\n \"purpose\": \"PROOF_OF_ADDRESS\",\n \"description\": \"Recent utility bill showing residential address\"\n }\n ],\n \"has_ownership\": true,\n \"ownership_percentage\": \"55.5\",\n \"has_control\": true,\n \"is_signer\": true,\n \"title\": \"Chief Executive Officer\"\n },\n {\n \"first_name\": \"Michael\",\n \"middle_name\": \"Alexander\",\n \"last_name\": \"Chen\",\n \"birth_date\": \"1982-11-08\",\n \"email\": \"[email protected]\",\n \"nationality\": \"US\",\n \"birth_country\": \"CN\",\n \"address\": {\n \"street_line_1\": \"456 Pine Street\",\n \"city\": \"Mountain View\",\n \"subdivision\": \"CA\",\n \"postal_code\": \"94040\",\n \"country\": \"USA\"\n },\n \"identification\": [\n {\n \"type\": \"ssn\",\n \"number\": \"322730792\",\n \"issuing_country\": \"US\"\n }\n ],\n \"documents\": [\n {\n \"file\": \"https://res.cloudinary.com/bullring-finance/image/upload/v1774564646/kyc/customers/070e5803-a6cc-4290-96d8-bed3c7084b84/sumsub_69c5b51632aa86f6ed120536_1362390373.jpg\",\n \"purpose\": \"PROOF_OF_ADDRESS\",\n \"description\": \"Recent utility bill showing residential address\"\n }\n ],\n \"has_ownership\": true,\n \"ownership_percentage\": \"44.5\",\n \"has_control\": false,\n \"is_signer\": true,\n \"title\": \"Chief Technology Officer\"\n }\n ],\n \"formation_document\": \"https://res.cloudinary.com/dgqsur6xy/image/upload/v1708994045/samples/cup-on-a-table.jpg\",\n \"ownership_document\": \"https://res.cloudinary.com/dgqsur6xy/image/upload/v1708994045/samples/cup-on-a-table.jpg\",\n \"flow_of_funds_document\": \"https://res.cloudinary.com/dgqsur6xy/image/upload/v1708994045/samples/cup-on-a-table.jpg\",\n \"proof_of_address_document\": \"https://res.cloudinary.com/dgqsur6xy/image/upload/v1708994045/samples/cup-on-a-table.jpg\",\n \"has_material_intermediary_ownership\": false,\n \"expected_monthly_volume_usd\": \"250000\",\n \"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\",\n \"acting_as_intermediary\": false\n}"
response = http.request(request)
puts response.read_body{
"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": "[email protected]",
"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
}{
"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"
}Authorizations
Path Parameters
The unique identifier of the subaccount
Body
application/json
The official registered legal name of the business entity
The trading name or brand name used by the business (also known as DBA - Doing Business As)
The primary tax identification number of the business
The business registration or incorporation number issued by the registering authority
The date when the business was officially incorporated or registered (format: YYYY-MM-DD)
A detailed description of the business activities, products, and services
The primary contact email address for the business
The primary source from which the business receives its funds
Available options:
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 The legal structure or type of the business entity
Available options:
cooperative, corporation, llc, other, partnership, sole_prop, trust The business website URL
The official registered address of the business as filed with government authorities
Show child attributes
Show child attributes
The actual physical location where the business operates (may differ from registered address)
Show child attributes
Show child attributes
Array of business tax identification documents. See Business ID Numbers for accepted document types.
Show child attributes
Show child attributes
Indicates whether the business is structured as a Decentralized Autonomous Organization (DAO)
Indicates whether the business operates as a money services business or money transmitter
Array of Industry codes of the industry or industries the business operates in. The can be gotten here Industry Codes
The primary intended use of the Bullring account
Available options:
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 Array of individuals who ultimately own or control the business (typically those with 25% or more ownership or significant control)
Show child attributes
Show child attributes
Certificate of Incorporation or similar document that proves the formation of the business. Supported document formats are jpeg, jpg, png, heic, heif, pdf
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"]
A document that proves the flow of funds for the business. Supported document formats are jpeg, jpg, png, heic, heif, pdf
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
Indicates whether any intermediary entities (e.g., holding companies, trusts) have material ownership in the business
The expected monthly transaction volume in USD (numeric string)
A detailed description of how the business generates its funds and revenue streams
Indicates whether the business acts as an intermediary or facilitator for third-party transactions
Response
Business information updated successfully
Available options:
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 Available options:
cooperative, corporation, llc, other, partnership, sole_prop, trust Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Array of Industry codes of the industry or industries the business operates in. The can be gotten here Industry Codes
Available options:
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 Show child attributes
Show child attributes
Supported document formats are jpeg, jpg, png, heic, heif, pdf
Supported document formats are jpeg, jpg, png, heic, heif, pdf
Supported document formats are jpeg, jpg, png, heic, heif, pdf
⌘I