Add/Update Individual Information
curl --request PATCH \
--url https://api.bullring.finance/v1/kyc/customers/{subaccountId} \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"first_name": "Sarah",
"middle_name": "Jane",
"last_name": "Smith",
"phone": "+447911123456",
"birth_date": "1985-06-22",
"gender": "f",
"nationality": "GBR",
"birth_country": "GB",
"address": {
"street_line_1": "10 Downing Street",
"street_line_2": "",
"city": "London",
"state": "LND",
"postal_code": "SW1A 2AA",
"country": "GBR"
},
"account_purpose": "personal_or_living_expenses",
"employment_status": "employed",
"expected_monthly_payments_usd": "FROM_10000_TO_49999",
"expected_monthly_volume_usd": "25000",
"acting_as_intermediary": false,
"most_recent_occupation": "SOFTWARE_DEVELOPER",
"source_of_funds": "salary",
"source_of_funds_description": "Software engineering salary from ABC Corporation",
"identifying_information": [
{
"type": "passport",
"issuing_country": "GBR",
"number": "532145678",
"image_front": "https://res.cloudinary.com/bullring-finance/image/upload/v1774565389/Gfsjlkjadfeuwk7rz.jpg",
"image_back": "https://res.cloudinary.com/bullring-finance/image/upload/v1774565389/Gfsjlkjadfeuwk7rz.jpg"
},
{
"type": "tin",
"issuing_country": "GBR",
"number": "AB123456C"
}
],
"documents": [
{
"purpose": "PROOF_OF_ADDRESS",
"file": "https://res.cloudinary.com/bullring-finance/image/upload/v1774567136/doc_a3057dd552b214274ef834dfsjkfskjs.jpg"
}
]
}
'import requests
url = "https://api.bullring.finance/v1/kyc/customers/{subaccountId}"
payload = {
"first_name": "Sarah",
"middle_name": "Jane",
"last_name": "Smith",
"phone": "+447911123456",
"birth_date": "1985-06-22",
"gender": "f",
"nationality": "GBR",
"birth_country": "GB",
"address": {
"street_line_1": "10 Downing Street",
"street_line_2": "",
"city": "London",
"state": "LND",
"postal_code": "SW1A 2AA",
"country": "GBR"
},
"account_purpose": "personal_or_living_expenses",
"employment_status": "employed",
"expected_monthly_payments_usd": "FROM_10000_TO_49999",
"expected_monthly_volume_usd": "25000",
"acting_as_intermediary": False,
"most_recent_occupation": "SOFTWARE_DEVELOPER",
"source_of_funds": "salary",
"source_of_funds_description": "Software engineering salary from ABC Corporation",
"identifying_information": [
{
"type": "passport",
"issuing_country": "GBR",
"number": "532145678",
"image_front": "https://res.cloudinary.com/bullring-finance/image/upload/v1774565389/Gfsjlkjadfeuwk7rz.jpg",
"image_back": "https://res.cloudinary.com/bullring-finance/image/upload/v1774565389/Gfsjlkjadfeuwk7rz.jpg"
},
{
"type": "tin",
"issuing_country": "GBR",
"number": "AB123456C"
}
],
"documents": [
{
"purpose": "PROOF_OF_ADDRESS",
"file": "https://res.cloudinary.com/bullring-finance/image/upload/v1774567136/doc_a3057dd552b214274ef834dfsjkfskjs.jpg"
}
]
}
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({
first_name: 'Sarah',
middle_name: 'Jane',
last_name: 'Smith',
phone: '+447911123456',
birth_date: '1985-06-22',
gender: 'f',
nationality: 'GBR',
birth_country: 'GB',
address: {
street_line_1: '10 Downing Street',
street_line_2: '',
city: 'London',
state: 'LND',
postal_code: 'SW1A 2AA',
country: 'GBR'
},
account_purpose: 'personal_or_living_expenses',
employment_status: 'employed',
expected_monthly_payments_usd: 'FROM_10000_TO_49999',
expected_monthly_volume_usd: '25000',
acting_as_intermediary: false,
most_recent_occupation: 'SOFTWARE_DEVELOPER',
source_of_funds: 'salary',
source_of_funds_description: 'Software engineering salary from ABC Corporation',
identifying_information: [
{
type: 'passport',
issuing_country: 'GBR',
number: '532145678',
image_front: 'https://res.cloudinary.com/bullring-finance/image/upload/v1774565389/Gfsjlkjadfeuwk7rz.jpg',
image_back: 'https://res.cloudinary.com/bullring-finance/image/upload/v1774565389/Gfsjlkjadfeuwk7rz.jpg'
},
{type: 'tin', issuing_country: 'GBR', number: 'AB123456C'}
],
documents: [
{
purpose: 'PROOF_OF_ADDRESS',
file: 'https://res.cloudinary.com/bullring-finance/image/upload/v1774567136/doc_a3057dd552b214274ef834dfsjkfskjs.jpg'
}
]
})
};
fetch('https://api.bullring.finance/v1/kyc/customers/{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/customers/{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([
'first_name' => 'Sarah',
'middle_name' => 'Jane',
'last_name' => 'Smith',
'phone' => '+447911123456',
'birth_date' => '1985-06-22',
'gender' => 'f',
'nationality' => 'GBR',
'birth_country' => 'GB',
'address' => [
'street_line_1' => '10 Downing Street',
'street_line_2' => '',
'city' => 'London',
'state' => 'LND',
'postal_code' => 'SW1A 2AA',
'country' => 'GBR'
],
'account_purpose' => 'personal_or_living_expenses',
'employment_status' => 'employed',
'expected_monthly_payments_usd' => 'FROM_10000_TO_49999',
'expected_monthly_volume_usd' => '25000',
'acting_as_intermediary' => false,
'most_recent_occupation' => 'SOFTWARE_DEVELOPER',
'source_of_funds' => 'salary',
'source_of_funds_description' => 'Software engineering salary from ABC Corporation',
'identifying_information' => [
[
'type' => 'passport',
'issuing_country' => 'GBR',
'number' => '532145678',
'image_front' => 'https://res.cloudinary.com/bullring-finance/image/upload/v1774565389/Gfsjlkjadfeuwk7rz.jpg',
'image_back' => 'https://res.cloudinary.com/bullring-finance/image/upload/v1774565389/Gfsjlkjadfeuwk7rz.jpg'
],
[
'type' => 'tin',
'issuing_country' => 'GBR',
'number' => 'AB123456C'
]
],
'documents' => [
[
'purpose' => 'PROOF_OF_ADDRESS',
'file' => 'https://res.cloudinary.com/bullring-finance/image/upload/v1774567136/doc_a3057dd552b214274ef834dfsjkfskjs.jpg'
]
]
]),
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/customers/{subaccountId}"
payload := strings.NewReader("{\n \"first_name\": \"Sarah\",\n \"middle_name\": \"Jane\",\n \"last_name\": \"Smith\",\n \"phone\": \"+447911123456\",\n \"birth_date\": \"1985-06-22\",\n \"gender\": \"f\",\n \"nationality\": \"GBR\",\n \"birth_country\": \"GB\",\n \"address\": {\n \"street_line_1\": \"10 Downing Street\",\n \"street_line_2\": \"\",\n \"city\": \"London\",\n \"state\": \"LND\",\n \"postal_code\": \"SW1A 2AA\",\n \"country\": \"GBR\"\n },\n \"account_purpose\": \"personal_or_living_expenses\",\n \"employment_status\": \"employed\",\n \"expected_monthly_payments_usd\": \"FROM_10000_TO_49999\",\n \"expected_monthly_volume_usd\": \"25000\",\n \"acting_as_intermediary\": false,\n \"most_recent_occupation\": \"SOFTWARE_DEVELOPER\",\n \"source_of_funds\": \"salary\",\n \"source_of_funds_description\": \"Software engineering salary from ABC Corporation\",\n \"identifying_information\": [\n {\n \"type\": \"passport\",\n \"issuing_country\": \"GBR\",\n \"number\": \"532145678\",\n \"image_front\": \"https://res.cloudinary.com/bullring-finance/image/upload/v1774565389/Gfsjlkjadfeuwk7rz.jpg\",\n \"image_back\": \"https://res.cloudinary.com/bullring-finance/image/upload/v1774565389/Gfsjlkjadfeuwk7rz.jpg\"\n },\n {\n \"type\": \"tin\",\n \"issuing_country\": \"GBR\",\n \"number\": \"AB123456C\"\n }\n ],\n \"documents\": [\n {\n \"purpose\": \"PROOF_OF_ADDRESS\",\n \"file\": \"https://res.cloudinary.com/bullring-finance/image/upload/v1774567136/doc_a3057dd552b214274ef834dfsjkfskjs.jpg\"\n }\n ]\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/customers/{subaccountId}")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"first_name\": \"Sarah\",\n \"middle_name\": \"Jane\",\n \"last_name\": \"Smith\",\n \"phone\": \"+447911123456\",\n \"birth_date\": \"1985-06-22\",\n \"gender\": \"f\",\n \"nationality\": \"GBR\",\n \"birth_country\": \"GB\",\n \"address\": {\n \"street_line_1\": \"10 Downing Street\",\n \"street_line_2\": \"\",\n \"city\": \"London\",\n \"state\": \"LND\",\n \"postal_code\": \"SW1A 2AA\",\n \"country\": \"GBR\"\n },\n \"account_purpose\": \"personal_or_living_expenses\",\n \"employment_status\": \"employed\",\n \"expected_monthly_payments_usd\": \"FROM_10000_TO_49999\",\n \"expected_monthly_volume_usd\": \"25000\",\n \"acting_as_intermediary\": false,\n \"most_recent_occupation\": \"SOFTWARE_DEVELOPER\",\n \"source_of_funds\": \"salary\",\n \"source_of_funds_description\": \"Software engineering salary from ABC Corporation\",\n \"identifying_information\": [\n {\n \"type\": \"passport\",\n \"issuing_country\": \"GBR\",\n \"number\": \"532145678\",\n \"image_front\": \"https://res.cloudinary.com/bullring-finance/image/upload/v1774565389/Gfsjlkjadfeuwk7rz.jpg\",\n \"image_back\": \"https://res.cloudinary.com/bullring-finance/image/upload/v1774565389/Gfsjlkjadfeuwk7rz.jpg\"\n },\n {\n \"type\": \"tin\",\n \"issuing_country\": \"GBR\",\n \"number\": \"AB123456C\"\n }\n ],\n \"documents\": [\n {\n \"purpose\": \"PROOF_OF_ADDRESS\",\n \"file\": \"https://res.cloudinary.com/bullring-finance/image/upload/v1774567136/doc_a3057dd552b214274ef834dfsjkfskjs.jpg\"\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bullring.finance/v1/kyc/customers/{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 \"first_name\": \"Sarah\",\n \"middle_name\": \"Jane\",\n \"last_name\": \"Smith\",\n \"phone\": \"+447911123456\",\n \"birth_date\": \"1985-06-22\",\n \"gender\": \"f\",\n \"nationality\": \"GBR\",\n \"birth_country\": \"GB\",\n \"address\": {\n \"street_line_1\": \"10 Downing Street\",\n \"street_line_2\": \"\",\n \"city\": \"London\",\n \"state\": \"LND\",\n \"postal_code\": \"SW1A 2AA\",\n \"country\": \"GBR\"\n },\n \"account_purpose\": \"personal_or_living_expenses\",\n \"employment_status\": \"employed\",\n \"expected_monthly_payments_usd\": \"FROM_10000_TO_49999\",\n \"expected_monthly_volume_usd\": \"25000\",\n \"acting_as_intermediary\": false,\n \"most_recent_occupation\": \"SOFTWARE_DEVELOPER\",\n \"source_of_funds\": \"salary\",\n \"source_of_funds_description\": \"Software engineering salary from ABC Corporation\",\n \"identifying_information\": [\n {\n \"type\": \"passport\",\n \"issuing_country\": \"GBR\",\n \"number\": \"532145678\",\n \"image_front\": \"https://res.cloudinary.com/bullring-finance/image/upload/v1774565389/Gfsjlkjadfeuwk7rz.jpg\",\n \"image_back\": \"https://res.cloudinary.com/bullring-finance/image/upload/v1774565389/Gfsjlkjadfeuwk7rz.jpg\"\n },\n {\n \"type\": \"tin\",\n \"issuing_country\": \"GBR\",\n \"number\": \"AB123456C\"\n }\n ],\n \"documents\": [\n {\n \"purpose\": \"PROOF_OF_ADDRESS\",\n \"file\": \"https://res.cloudinary.com/bullring-finance/image/upload/v1774567136/doc_a3057dd552b214274ef834dfsjkfskjs.jpg\"\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"status": "not_started",
"created_at": "2025-11-21T15:32:51.901Z",
"updated_at": "2025-12-31T10:17:21.319Z",
"type": "individual",
"first_name": "Sarah",
"middle_name": "Jane",
"last_name": "Smith",
"phone": "+447911123456",
"birth_date": "1985-06-22T00:00:00.000Z",
"gender": "f",
"nationality": "GBR",
"birth_country": "GB",
"address": {
"street_line_1": "10 Downing Street",
"street_line_2": "",
"city": "London",
"state": "LND",
"postal_code": "SW1A 2AA",
"country": "GBR"
},
"documents": [
{
"purpose": "PROOF_OF_ADDRESS",
"file": "https://res.cloudinary.com/bullring-finance/image/upload/v1774567136/doc_a3057dd552b214274ef834dfsjkfskjs.jpg"
}
],
"account_purpose": "personal_or_living_expenses",
"account_purpose_other": null,
"employment_status": "employed",
"expected_monthly_payments_usd": "FROM_10000_TO_49999",
"expected_monthly_volume_usd": "25000",
"acting_as_intermediary": false,
"most_recent_occupation": "SOFTWARE_DEVELOPER",
"source_of_funds": "salary",
"source_of_funds_description": "Software engineering salary from ABC Corporation",
"identifying_information": [
{
"type": "passport",
"issuing_country": "GBR",
"number": "532145678",
"image_front": "https://res.cloudinary.com/bullring-finance/image/upload/v1774565389/Gfsjlkjadfeuwk7rz.jpg",
"image_back": "https://res.cloudinary.com/bullring-finance/image/upload/v1774565389/Gfsjlkjadfeuwk7rz.jpg"
},
{
"type": "tin",
"issuing_country": "GBR",
"number": "AB123456C"
}
]
}Verification
Add/Update Individual Information
Add or update the KYC information for a customer.
PATCH
/
v1
/
kyc
/
customers
/
{subaccountId}
Add/Update Individual Information
curl --request PATCH \
--url https://api.bullring.finance/v1/kyc/customers/{subaccountId} \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"first_name": "Sarah",
"middle_name": "Jane",
"last_name": "Smith",
"phone": "+447911123456",
"birth_date": "1985-06-22",
"gender": "f",
"nationality": "GBR",
"birth_country": "GB",
"address": {
"street_line_1": "10 Downing Street",
"street_line_2": "",
"city": "London",
"state": "LND",
"postal_code": "SW1A 2AA",
"country": "GBR"
},
"account_purpose": "personal_or_living_expenses",
"employment_status": "employed",
"expected_monthly_payments_usd": "FROM_10000_TO_49999",
"expected_monthly_volume_usd": "25000",
"acting_as_intermediary": false,
"most_recent_occupation": "SOFTWARE_DEVELOPER",
"source_of_funds": "salary",
"source_of_funds_description": "Software engineering salary from ABC Corporation",
"identifying_information": [
{
"type": "passport",
"issuing_country": "GBR",
"number": "532145678",
"image_front": "https://res.cloudinary.com/bullring-finance/image/upload/v1774565389/Gfsjlkjadfeuwk7rz.jpg",
"image_back": "https://res.cloudinary.com/bullring-finance/image/upload/v1774565389/Gfsjlkjadfeuwk7rz.jpg"
},
{
"type": "tin",
"issuing_country": "GBR",
"number": "AB123456C"
}
],
"documents": [
{
"purpose": "PROOF_OF_ADDRESS",
"file": "https://res.cloudinary.com/bullring-finance/image/upload/v1774567136/doc_a3057dd552b214274ef834dfsjkfskjs.jpg"
}
]
}
'import requests
url = "https://api.bullring.finance/v1/kyc/customers/{subaccountId}"
payload = {
"first_name": "Sarah",
"middle_name": "Jane",
"last_name": "Smith",
"phone": "+447911123456",
"birth_date": "1985-06-22",
"gender": "f",
"nationality": "GBR",
"birth_country": "GB",
"address": {
"street_line_1": "10 Downing Street",
"street_line_2": "",
"city": "London",
"state": "LND",
"postal_code": "SW1A 2AA",
"country": "GBR"
},
"account_purpose": "personal_or_living_expenses",
"employment_status": "employed",
"expected_monthly_payments_usd": "FROM_10000_TO_49999",
"expected_monthly_volume_usd": "25000",
"acting_as_intermediary": False,
"most_recent_occupation": "SOFTWARE_DEVELOPER",
"source_of_funds": "salary",
"source_of_funds_description": "Software engineering salary from ABC Corporation",
"identifying_information": [
{
"type": "passport",
"issuing_country": "GBR",
"number": "532145678",
"image_front": "https://res.cloudinary.com/bullring-finance/image/upload/v1774565389/Gfsjlkjadfeuwk7rz.jpg",
"image_back": "https://res.cloudinary.com/bullring-finance/image/upload/v1774565389/Gfsjlkjadfeuwk7rz.jpg"
},
{
"type": "tin",
"issuing_country": "GBR",
"number": "AB123456C"
}
],
"documents": [
{
"purpose": "PROOF_OF_ADDRESS",
"file": "https://res.cloudinary.com/bullring-finance/image/upload/v1774567136/doc_a3057dd552b214274ef834dfsjkfskjs.jpg"
}
]
}
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({
first_name: 'Sarah',
middle_name: 'Jane',
last_name: 'Smith',
phone: '+447911123456',
birth_date: '1985-06-22',
gender: 'f',
nationality: 'GBR',
birth_country: 'GB',
address: {
street_line_1: '10 Downing Street',
street_line_2: '',
city: 'London',
state: 'LND',
postal_code: 'SW1A 2AA',
country: 'GBR'
},
account_purpose: 'personal_or_living_expenses',
employment_status: 'employed',
expected_monthly_payments_usd: 'FROM_10000_TO_49999',
expected_monthly_volume_usd: '25000',
acting_as_intermediary: false,
most_recent_occupation: 'SOFTWARE_DEVELOPER',
source_of_funds: 'salary',
source_of_funds_description: 'Software engineering salary from ABC Corporation',
identifying_information: [
{
type: 'passport',
issuing_country: 'GBR',
number: '532145678',
image_front: 'https://res.cloudinary.com/bullring-finance/image/upload/v1774565389/Gfsjlkjadfeuwk7rz.jpg',
image_back: 'https://res.cloudinary.com/bullring-finance/image/upload/v1774565389/Gfsjlkjadfeuwk7rz.jpg'
},
{type: 'tin', issuing_country: 'GBR', number: 'AB123456C'}
],
documents: [
{
purpose: 'PROOF_OF_ADDRESS',
file: 'https://res.cloudinary.com/bullring-finance/image/upload/v1774567136/doc_a3057dd552b214274ef834dfsjkfskjs.jpg'
}
]
})
};
fetch('https://api.bullring.finance/v1/kyc/customers/{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/customers/{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([
'first_name' => 'Sarah',
'middle_name' => 'Jane',
'last_name' => 'Smith',
'phone' => '+447911123456',
'birth_date' => '1985-06-22',
'gender' => 'f',
'nationality' => 'GBR',
'birth_country' => 'GB',
'address' => [
'street_line_1' => '10 Downing Street',
'street_line_2' => '',
'city' => 'London',
'state' => 'LND',
'postal_code' => 'SW1A 2AA',
'country' => 'GBR'
],
'account_purpose' => 'personal_or_living_expenses',
'employment_status' => 'employed',
'expected_monthly_payments_usd' => 'FROM_10000_TO_49999',
'expected_monthly_volume_usd' => '25000',
'acting_as_intermediary' => false,
'most_recent_occupation' => 'SOFTWARE_DEVELOPER',
'source_of_funds' => 'salary',
'source_of_funds_description' => 'Software engineering salary from ABC Corporation',
'identifying_information' => [
[
'type' => 'passport',
'issuing_country' => 'GBR',
'number' => '532145678',
'image_front' => 'https://res.cloudinary.com/bullring-finance/image/upload/v1774565389/Gfsjlkjadfeuwk7rz.jpg',
'image_back' => 'https://res.cloudinary.com/bullring-finance/image/upload/v1774565389/Gfsjlkjadfeuwk7rz.jpg'
],
[
'type' => 'tin',
'issuing_country' => 'GBR',
'number' => 'AB123456C'
]
],
'documents' => [
[
'purpose' => 'PROOF_OF_ADDRESS',
'file' => 'https://res.cloudinary.com/bullring-finance/image/upload/v1774567136/doc_a3057dd552b214274ef834dfsjkfskjs.jpg'
]
]
]),
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/customers/{subaccountId}"
payload := strings.NewReader("{\n \"first_name\": \"Sarah\",\n \"middle_name\": \"Jane\",\n \"last_name\": \"Smith\",\n \"phone\": \"+447911123456\",\n \"birth_date\": \"1985-06-22\",\n \"gender\": \"f\",\n \"nationality\": \"GBR\",\n \"birth_country\": \"GB\",\n \"address\": {\n \"street_line_1\": \"10 Downing Street\",\n \"street_line_2\": \"\",\n \"city\": \"London\",\n \"state\": \"LND\",\n \"postal_code\": \"SW1A 2AA\",\n \"country\": \"GBR\"\n },\n \"account_purpose\": \"personal_or_living_expenses\",\n \"employment_status\": \"employed\",\n \"expected_monthly_payments_usd\": \"FROM_10000_TO_49999\",\n \"expected_monthly_volume_usd\": \"25000\",\n \"acting_as_intermediary\": false,\n \"most_recent_occupation\": \"SOFTWARE_DEVELOPER\",\n \"source_of_funds\": \"salary\",\n \"source_of_funds_description\": \"Software engineering salary from ABC Corporation\",\n \"identifying_information\": [\n {\n \"type\": \"passport\",\n \"issuing_country\": \"GBR\",\n \"number\": \"532145678\",\n \"image_front\": \"https://res.cloudinary.com/bullring-finance/image/upload/v1774565389/Gfsjlkjadfeuwk7rz.jpg\",\n \"image_back\": \"https://res.cloudinary.com/bullring-finance/image/upload/v1774565389/Gfsjlkjadfeuwk7rz.jpg\"\n },\n {\n \"type\": \"tin\",\n \"issuing_country\": \"GBR\",\n \"number\": \"AB123456C\"\n }\n ],\n \"documents\": [\n {\n \"purpose\": \"PROOF_OF_ADDRESS\",\n \"file\": \"https://res.cloudinary.com/bullring-finance/image/upload/v1774567136/doc_a3057dd552b214274ef834dfsjkfskjs.jpg\"\n }\n ]\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/customers/{subaccountId}")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"first_name\": \"Sarah\",\n \"middle_name\": \"Jane\",\n \"last_name\": \"Smith\",\n \"phone\": \"+447911123456\",\n \"birth_date\": \"1985-06-22\",\n \"gender\": \"f\",\n \"nationality\": \"GBR\",\n \"birth_country\": \"GB\",\n \"address\": {\n \"street_line_1\": \"10 Downing Street\",\n \"street_line_2\": \"\",\n \"city\": \"London\",\n \"state\": \"LND\",\n \"postal_code\": \"SW1A 2AA\",\n \"country\": \"GBR\"\n },\n \"account_purpose\": \"personal_or_living_expenses\",\n \"employment_status\": \"employed\",\n \"expected_monthly_payments_usd\": \"FROM_10000_TO_49999\",\n \"expected_monthly_volume_usd\": \"25000\",\n \"acting_as_intermediary\": false,\n \"most_recent_occupation\": \"SOFTWARE_DEVELOPER\",\n \"source_of_funds\": \"salary\",\n \"source_of_funds_description\": \"Software engineering salary from ABC Corporation\",\n \"identifying_information\": [\n {\n \"type\": \"passport\",\n \"issuing_country\": \"GBR\",\n \"number\": \"532145678\",\n \"image_front\": \"https://res.cloudinary.com/bullring-finance/image/upload/v1774565389/Gfsjlkjadfeuwk7rz.jpg\",\n \"image_back\": \"https://res.cloudinary.com/bullring-finance/image/upload/v1774565389/Gfsjlkjadfeuwk7rz.jpg\"\n },\n {\n \"type\": \"tin\",\n \"issuing_country\": \"GBR\",\n \"number\": \"AB123456C\"\n }\n ],\n \"documents\": [\n {\n \"purpose\": \"PROOF_OF_ADDRESS\",\n \"file\": \"https://res.cloudinary.com/bullring-finance/image/upload/v1774567136/doc_a3057dd552b214274ef834dfsjkfskjs.jpg\"\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bullring.finance/v1/kyc/customers/{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 \"first_name\": \"Sarah\",\n \"middle_name\": \"Jane\",\n \"last_name\": \"Smith\",\n \"phone\": \"+447911123456\",\n \"birth_date\": \"1985-06-22\",\n \"gender\": \"f\",\n \"nationality\": \"GBR\",\n \"birth_country\": \"GB\",\n \"address\": {\n \"street_line_1\": \"10 Downing Street\",\n \"street_line_2\": \"\",\n \"city\": \"London\",\n \"state\": \"LND\",\n \"postal_code\": \"SW1A 2AA\",\n \"country\": \"GBR\"\n },\n \"account_purpose\": \"personal_or_living_expenses\",\n \"employment_status\": \"employed\",\n \"expected_monthly_payments_usd\": \"FROM_10000_TO_49999\",\n \"expected_monthly_volume_usd\": \"25000\",\n \"acting_as_intermediary\": false,\n \"most_recent_occupation\": \"SOFTWARE_DEVELOPER\",\n \"source_of_funds\": \"salary\",\n \"source_of_funds_description\": \"Software engineering salary from ABC Corporation\",\n \"identifying_information\": [\n {\n \"type\": \"passport\",\n \"issuing_country\": \"GBR\",\n \"number\": \"532145678\",\n \"image_front\": \"https://res.cloudinary.com/bullring-finance/image/upload/v1774565389/Gfsjlkjadfeuwk7rz.jpg\",\n \"image_back\": \"https://res.cloudinary.com/bullring-finance/image/upload/v1774565389/Gfsjlkjadfeuwk7rz.jpg\"\n },\n {\n \"type\": \"tin\",\n \"issuing_country\": \"GBR\",\n \"number\": \"AB123456C\"\n }\n ],\n \"documents\": [\n {\n \"purpose\": \"PROOF_OF_ADDRESS\",\n \"file\": \"https://res.cloudinary.com/bullring-finance/image/upload/v1774567136/doc_a3057dd552b214274ef834dfsjkfskjs.jpg\"\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"status": "not_started",
"created_at": "2025-11-21T15:32:51.901Z",
"updated_at": "2025-12-31T10:17:21.319Z",
"type": "individual",
"first_name": "Sarah",
"middle_name": "Jane",
"last_name": "Smith",
"phone": "+447911123456",
"birth_date": "1985-06-22T00:00:00.000Z",
"gender": "f",
"nationality": "GBR",
"birth_country": "GB",
"address": {
"street_line_1": "10 Downing Street",
"street_line_2": "",
"city": "London",
"state": "LND",
"postal_code": "SW1A 2AA",
"country": "GBR"
},
"documents": [
{
"purpose": "PROOF_OF_ADDRESS",
"file": "https://res.cloudinary.com/bullring-finance/image/upload/v1774567136/doc_a3057dd552b214274ef834dfsjkfskjs.jpg"
}
],
"account_purpose": "personal_or_living_expenses",
"account_purpose_other": null,
"employment_status": "employed",
"expected_monthly_payments_usd": "FROM_10000_TO_49999",
"expected_monthly_volume_usd": "25000",
"acting_as_intermediary": false,
"most_recent_occupation": "SOFTWARE_DEVELOPER",
"source_of_funds": "salary",
"source_of_funds_description": "Software engineering salary from ABC Corporation",
"identifying_information": [
{
"type": "passport",
"issuing_country": "GBR",
"number": "532145678",
"image_front": "https://res.cloudinary.com/bullring-finance/image/upload/v1774565389/Gfsjlkjadfeuwk7rz.jpg",
"image_back": "https://res.cloudinary.com/bullring-finance/image/upload/v1774565389/Gfsjlkjadfeuwk7rz.jpg"
},
{
"type": "tin",
"issuing_country": "GBR",
"number": "AB123456C"
}
]
}Authorizations
Path Parameters
The unique identifier of the subaccount
Body
application/json
Phone number of the customer. Must be in E.164 format (e.g., +2348012345678)
Show child attributes
Show child attributes
Must be formatted as YYYY-MM-DD
three-letter ISO 3166-1 code for the country (e.g., "NGA" for Nigeria). See ISO 3166-1
two-letter ISO 3166-1 alpha-2 code for the country (e.g., "DE").
Available options:
CHARITABLE_DONATIONS, ECOMMERCE_RETAIL_PAYMENTS, INVESTMENT_PURPOSES, OPERATING_A_COMPANY, OTHER, PAYMENTS_TO_FRIENDS_OR_FAMILY_ABROAD, PERSONAL_OR_LIVING_EXPENSES, PROTECT_WEALTH, PURCHASE_GOODS_AND_SERVICES, RECEIVE_PAYMENT_FOR_FREELANCING, RECEIVE_SALARY Available options:
EMPLOYED, HOMEMAKER, RETIRED, SELF_EMPLOYED, STUDENT, UNEMPLOYED Available options:
UP_TO_4999, FROM_5000_TO_9999, FROM_10000_TO_49999, FROM_50000 Fetch from occupation endpoint: /api-reference/verification/get-occupations
Available options:
company_funds, ecommerce_reseller, gambling_proceeds, gifts, government_benefits, inheritance, investments_loans, pension_retirement, salary, sale_of_assets_real_estate, savings, someone_elses_funds Array of identification documents. See Accepted ID Documents by Country for country-specific requirements.
Show child attributes
Show child attributes
Response
200 - application/json
Customer information updated successfully
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Fetch from occupation endpoint: /api-reference/verification/get-occupations
Available options:
company_funds, ecommerce_reseller, gambling_proceeds, gifts, government_benefits, inheritance, investments_loans, pension_retirement, salary, sale_of_assets_real_estate, savings, someone_elses_funds Array of identification documents. See Accepted ID Documents by Country for country-specific requirements.
Show child attributes
Show child attributes
⌘I