Update a single associated person
curl --request PUT \
--url https://api.bridge.xyz/v0/customers/{customerID}/associated_persons/{associatedPersonID} \
--header 'Api-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"first_name": "<string>",
"last_name": "<string>",
"email": "<string>",
"residential_address": {
"street_line_1": "<string>",
"city": "<string>",
"country": "<string>",
"street_line_2": "<string>",
"subdivision": "<string>",
"postal_code": "<string>"
},
"birth_date": "<string>",
"has_ownership": true,
"has_control": true,
"is_signer": true,
"identifying_information": [
{
"issuing_country": "<string>",
"number": "<string>",
"description": "<string>",
"expiration": "<string>",
"image_front": "<string>",
"image_back": "<string>"
}
],
"middle_name": "<string>",
"transliterated_first_name": "<string>",
"transliterated_middle_name": "<string>",
"transliterated_last_name": "<string>",
"phone": "<string>",
"nationality": "<string>",
"nationalities": [
"<string>"
],
"place_of_birth": {
"country": "<string>",
"city": "<string>"
},
"verified_database_at": "2023-11-07T05:31:56Z",
"is_director": true,
"title": "<string>",
"ownership_percentage": 123,
"attested_ownership_structure_at": "<string>",
"verified_account_authorization_at": "2023-11-07T05:31:56Z",
"relationship_established_at": "<string>",
"verified_govid_at": "2023-11-07T05:31:56Z",
"verified_selfie_at": "2023-11-07T05:31:56Z",
"documents": [
{
"purposes": [],
"file": "<string>",
"description": "<string>"
}
]
}
'import requests
url = "https://api.bridge.xyz/v0/customers/{customerID}/associated_persons/{associatedPersonID}"
payload = {
"first_name": "<string>",
"last_name": "<string>",
"email": "<string>",
"residential_address": {
"street_line_1": "<string>",
"city": "<string>",
"country": "<string>",
"street_line_2": "<string>",
"subdivision": "<string>",
"postal_code": "<string>"
},
"birth_date": "<string>",
"has_ownership": True,
"has_control": True,
"is_signer": True,
"identifying_information": [
{
"issuing_country": "<string>",
"number": "<string>",
"description": "<string>",
"expiration": "<string>",
"image_front": "<string>",
"image_back": "<string>"
}
],
"middle_name": "<string>",
"transliterated_first_name": "<string>",
"transliterated_middle_name": "<string>",
"transliterated_last_name": "<string>",
"phone": "<string>",
"nationality": "<string>",
"nationalities": ["<string>"],
"place_of_birth": {
"country": "<string>",
"city": "<string>"
},
"verified_database_at": "2023-11-07T05:31:56Z",
"is_director": True,
"title": "<string>",
"ownership_percentage": 123,
"attested_ownership_structure_at": "<string>",
"verified_account_authorization_at": "2023-11-07T05:31:56Z",
"relationship_established_at": "<string>",
"verified_govid_at": "2023-11-07T05:31:56Z",
"verified_selfie_at": "2023-11-07T05:31:56Z",
"documents": [
{
"purposes": [],
"file": "<string>",
"description": "<string>"
}
]
}
headers = {
"Api-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {'Api-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
first_name: '<string>',
last_name: '<string>',
email: '<string>',
residential_address: {
street_line_1: '<string>',
city: '<string>',
country: '<string>',
street_line_2: '<string>',
subdivision: '<string>',
postal_code: '<string>'
},
birth_date: '<string>',
has_ownership: true,
has_control: true,
is_signer: true,
identifying_information: [
{
issuing_country: '<string>',
number: '<string>',
description: '<string>',
expiration: '<string>',
image_front: '<string>',
image_back: '<string>'
}
],
middle_name: '<string>',
transliterated_first_name: '<string>',
transliterated_middle_name: '<string>',
transliterated_last_name: '<string>',
phone: '<string>',
nationality: '<string>',
nationalities: ['<string>'],
place_of_birth: {country: '<string>', city: '<string>'},
verified_database_at: '2023-11-07T05:31:56Z',
is_director: true,
title: '<string>',
ownership_percentage: 123,
attested_ownership_structure_at: '<string>',
verified_account_authorization_at: '2023-11-07T05:31:56Z',
relationship_established_at: '<string>',
verified_govid_at: '2023-11-07T05:31:56Z',
verified_selfie_at: '2023-11-07T05:31:56Z',
documents: [{purposes: [], file: '<string>', description: '<string>'}]
})
};
fetch('https://api.bridge.xyz/v0/customers/{customerID}/associated_persons/{associatedPersonID}', 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.bridge.xyz/v0/customers/{customerID}/associated_persons/{associatedPersonID}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'first_name' => '<string>',
'last_name' => '<string>',
'email' => '<string>',
'residential_address' => [
'street_line_1' => '<string>',
'city' => '<string>',
'country' => '<string>',
'street_line_2' => '<string>',
'subdivision' => '<string>',
'postal_code' => '<string>'
],
'birth_date' => '<string>',
'has_ownership' => true,
'has_control' => true,
'is_signer' => true,
'identifying_information' => [
[
'issuing_country' => '<string>',
'number' => '<string>',
'description' => '<string>',
'expiration' => '<string>',
'image_front' => '<string>',
'image_back' => '<string>'
]
],
'middle_name' => '<string>',
'transliterated_first_name' => '<string>',
'transliterated_middle_name' => '<string>',
'transliterated_last_name' => '<string>',
'phone' => '<string>',
'nationality' => '<string>',
'nationalities' => [
'<string>'
],
'place_of_birth' => [
'country' => '<string>',
'city' => '<string>'
],
'verified_database_at' => '2023-11-07T05:31:56Z',
'is_director' => true,
'title' => '<string>',
'ownership_percentage' => 123,
'attested_ownership_structure_at' => '<string>',
'verified_account_authorization_at' => '2023-11-07T05:31:56Z',
'relationship_established_at' => '<string>',
'verified_govid_at' => '2023-11-07T05:31:56Z',
'verified_selfie_at' => '2023-11-07T05:31:56Z',
'documents' => [
[
'purposes' => [
],
'file' => '<string>',
'description' => '<string>'
]
]
]),
CURLOPT_HTTPHEADER => [
"Api-Key: <api-key>",
"Content-Type: application/json"
],
]);
$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.bridge.xyz/v0/customers/{customerID}/associated_persons/{associatedPersonID}"
payload := strings.NewReader("{\n \"first_name\": \"<string>\",\n \"last_name\": \"<string>\",\n \"email\": \"<string>\",\n \"residential_address\": {\n \"street_line_1\": \"<string>\",\n \"city\": \"<string>\",\n \"country\": \"<string>\",\n \"street_line_2\": \"<string>\",\n \"subdivision\": \"<string>\",\n \"postal_code\": \"<string>\"\n },\n \"birth_date\": \"<string>\",\n \"has_ownership\": true,\n \"has_control\": true,\n \"is_signer\": true,\n \"identifying_information\": [\n {\n \"issuing_country\": \"<string>\",\n \"number\": \"<string>\",\n \"description\": \"<string>\",\n \"expiration\": \"<string>\",\n \"image_front\": \"<string>\",\n \"image_back\": \"<string>\"\n }\n ],\n \"middle_name\": \"<string>\",\n \"transliterated_first_name\": \"<string>\",\n \"transliterated_middle_name\": \"<string>\",\n \"transliterated_last_name\": \"<string>\",\n \"phone\": \"<string>\",\n \"nationality\": \"<string>\",\n \"nationalities\": [\n \"<string>\"\n ],\n \"place_of_birth\": {\n \"country\": \"<string>\",\n \"city\": \"<string>\"\n },\n \"verified_database_at\": \"2023-11-07T05:31:56Z\",\n \"is_director\": true,\n \"title\": \"<string>\",\n \"ownership_percentage\": 123,\n \"attested_ownership_structure_at\": \"<string>\",\n \"verified_account_authorization_at\": \"2023-11-07T05:31:56Z\",\n \"relationship_established_at\": \"<string>\",\n \"verified_govid_at\": \"2023-11-07T05:31:56Z\",\n \"verified_selfie_at\": \"2023-11-07T05:31:56Z\",\n \"documents\": [\n {\n \"purposes\": [],\n \"file\": \"<string>\",\n \"description\": \"<string>\"\n }\n ]\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("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.put("https://api.bridge.xyz/v0/customers/{customerID}/associated_persons/{associatedPersonID}")
.header("Api-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"first_name\": \"<string>\",\n \"last_name\": \"<string>\",\n \"email\": \"<string>\",\n \"residential_address\": {\n \"street_line_1\": \"<string>\",\n \"city\": \"<string>\",\n \"country\": \"<string>\",\n \"street_line_2\": \"<string>\",\n \"subdivision\": \"<string>\",\n \"postal_code\": \"<string>\"\n },\n \"birth_date\": \"<string>\",\n \"has_ownership\": true,\n \"has_control\": true,\n \"is_signer\": true,\n \"identifying_information\": [\n {\n \"issuing_country\": \"<string>\",\n \"number\": \"<string>\",\n \"description\": \"<string>\",\n \"expiration\": \"<string>\",\n \"image_front\": \"<string>\",\n \"image_back\": \"<string>\"\n }\n ],\n \"middle_name\": \"<string>\",\n \"transliterated_first_name\": \"<string>\",\n \"transliterated_middle_name\": \"<string>\",\n \"transliterated_last_name\": \"<string>\",\n \"phone\": \"<string>\",\n \"nationality\": \"<string>\",\n \"nationalities\": [\n \"<string>\"\n ],\n \"place_of_birth\": {\n \"country\": \"<string>\",\n \"city\": \"<string>\"\n },\n \"verified_database_at\": \"2023-11-07T05:31:56Z\",\n \"is_director\": true,\n \"title\": \"<string>\",\n \"ownership_percentage\": 123,\n \"attested_ownership_structure_at\": \"<string>\",\n \"verified_account_authorization_at\": \"2023-11-07T05:31:56Z\",\n \"relationship_established_at\": \"<string>\",\n \"verified_govid_at\": \"2023-11-07T05:31:56Z\",\n \"verified_selfie_at\": \"2023-11-07T05:31:56Z\",\n \"documents\": [\n {\n \"purposes\": [],\n \"file\": \"<string>\",\n \"description\": \"<string>\"\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bridge.xyz/v0/customers/{customerID}/associated_persons/{associatedPersonID}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Api-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"first_name\": \"<string>\",\n \"last_name\": \"<string>\",\n \"email\": \"<string>\",\n \"residential_address\": {\n \"street_line_1\": \"<string>\",\n \"city\": \"<string>\",\n \"country\": \"<string>\",\n \"street_line_2\": \"<string>\",\n \"subdivision\": \"<string>\",\n \"postal_code\": \"<string>\"\n },\n \"birth_date\": \"<string>\",\n \"has_ownership\": true,\n \"has_control\": true,\n \"is_signer\": true,\n \"identifying_information\": [\n {\n \"issuing_country\": \"<string>\",\n \"number\": \"<string>\",\n \"description\": \"<string>\",\n \"expiration\": \"<string>\",\n \"image_front\": \"<string>\",\n \"image_back\": \"<string>\"\n }\n ],\n \"middle_name\": \"<string>\",\n \"transliterated_first_name\": \"<string>\",\n \"transliterated_middle_name\": \"<string>\",\n \"transliterated_last_name\": \"<string>\",\n \"phone\": \"<string>\",\n \"nationality\": \"<string>\",\n \"nationalities\": [\n \"<string>\"\n ],\n \"place_of_birth\": {\n \"country\": \"<string>\",\n \"city\": \"<string>\"\n },\n \"verified_database_at\": \"2023-11-07T05:31:56Z\",\n \"is_director\": true,\n \"title\": \"<string>\",\n \"ownership_percentage\": 123,\n \"attested_ownership_structure_at\": \"<string>\",\n \"verified_account_authorization_at\": \"2023-11-07T05:31:56Z\",\n \"relationship_established_at\": \"<string>\",\n \"verified_govid_at\": \"2023-11-07T05:31:56Z\",\n \"verified_selfie_at\": \"2023-11-07T05:31:56Z\",\n \"documents\": [\n {\n \"purposes\": [],\n \"file\": \"<string>\",\n \"description\": \"<string>\"\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"id": "associated_person_1234567890",
"email": "associated_person@business.co",
"first_name": "John",
"last_name": "Smith",
"has_ownership": true,
"has_control": true,
"is_signer": true,
"title": "Chief Executive Officer",
"relationship_established_at": "2025-05-27T17:55:33.308Z",
"created_at": "2025-05-27T17:55:33.308Z",
"updated_at": "2025-05-27T17:55:33.308Z"
}
Customers
Update a single associated person
PUT
/
customers
/
{customerID}
/
associated_persons
/
{associatedPersonID}
Update a single associated person
curl --request PUT \
--url https://api.bridge.xyz/v0/customers/{customerID}/associated_persons/{associatedPersonID} \
--header 'Api-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"first_name": "<string>",
"last_name": "<string>",
"email": "<string>",
"residential_address": {
"street_line_1": "<string>",
"city": "<string>",
"country": "<string>",
"street_line_2": "<string>",
"subdivision": "<string>",
"postal_code": "<string>"
},
"birth_date": "<string>",
"has_ownership": true,
"has_control": true,
"is_signer": true,
"identifying_information": [
{
"issuing_country": "<string>",
"number": "<string>",
"description": "<string>",
"expiration": "<string>",
"image_front": "<string>",
"image_back": "<string>"
}
],
"middle_name": "<string>",
"transliterated_first_name": "<string>",
"transliterated_middle_name": "<string>",
"transliterated_last_name": "<string>",
"phone": "<string>",
"nationality": "<string>",
"nationalities": [
"<string>"
],
"place_of_birth": {
"country": "<string>",
"city": "<string>"
},
"verified_database_at": "2023-11-07T05:31:56Z",
"is_director": true,
"title": "<string>",
"ownership_percentage": 123,
"attested_ownership_structure_at": "<string>",
"verified_account_authorization_at": "2023-11-07T05:31:56Z",
"relationship_established_at": "<string>",
"verified_govid_at": "2023-11-07T05:31:56Z",
"verified_selfie_at": "2023-11-07T05:31:56Z",
"documents": [
{
"purposes": [],
"file": "<string>",
"description": "<string>"
}
]
}
'import requests
url = "https://api.bridge.xyz/v0/customers/{customerID}/associated_persons/{associatedPersonID}"
payload = {
"first_name": "<string>",
"last_name": "<string>",
"email": "<string>",
"residential_address": {
"street_line_1": "<string>",
"city": "<string>",
"country": "<string>",
"street_line_2": "<string>",
"subdivision": "<string>",
"postal_code": "<string>"
},
"birth_date": "<string>",
"has_ownership": True,
"has_control": True,
"is_signer": True,
"identifying_information": [
{
"issuing_country": "<string>",
"number": "<string>",
"description": "<string>",
"expiration": "<string>",
"image_front": "<string>",
"image_back": "<string>"
}
],
"middle_name": "<string>",
"transliterated_first_name": "<string>",
"transliterated_middle_name": "<string>",
"transliterated_last_name": "<string>",
"phone": "<string>",
"nationality": "<string>",
"nationalities": ["<string>"],
"place_of_birth": {
"country": "<string>",
"city": "<string>"
},
"verified_database_at": "2023-11-07T05:31:56Z",
"is_director": True,
"title": "<string>",
"ownership_percentage": 123,
"attested_ownership_structure_at": "<string>",
"verified_account_authorization_at": "2023-11-07T05:31:56Z",
"relationship_established_at": "<string>",
"verified_govid_at": "2023-11-07T05:31:56Z",
"verified_selfie_at": "2023-11-07T05:31:56Z",
"documents": [
{
"purposes": [],
"file": "<string>",
"description": "<string>"
}
]
}
headers = {
"Api-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {'Api-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
first_name: '<string>',
last_name: '<string>',
email: '<string>',
residential_address: {
street_line_1: '<string>',
city: '<string>',
country: '<string>',
street_line_2: '<string>',
subdivision: '<string>',
postal_code: '<string>'
},
birth_date: '<string>',
has_ownership: true,
has_control: true,
is_signer: true,
identifying_information: [
{
issuing_country: '<string>',
number: '<string>',
description: '<string>',
expiration: '<string>',
image_front: '<string>',
image_back: '<string>'
}
],
middle_name: '<string>',
transliterated_first_name: '<string>',
transliterated_middle_name: '<string>',
transliterated_last_name: '<string>',
phone: '<string>',
nationality: '<string>',
nationalities: ['<string>'],
place_of_birth: {country: '<string>', city: '<string>'},
verified_database_at: '2023-11-07T05:31:56Z',
is_director: true,
title: '<string>',
ownership_percentage: 123,
attested_ownership_structure_at: '<string>',
verified_account_authorization_at: '2023-11-07T05:31:56Z',
relationship_established_at: '<string>',
verified_govid_at: '2023-11-07T05:31:56Z',
verified_selfie_at: '2023-11-07T05:31:56Z',
documents: [{purposes: [], file: '<string>', description: '<string>'}]
})
};
fetch('https://api.bridge.xyz/v0/customers/{customerID}/associated_persons/{associatedPersonID}', 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.bridge.xyz/v0/customers/{customerID}/associated_persons/{associatedPersonID}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'first_name' => '<string>',
'last_name' => '<string>',
'email' => '<string>',
'residential_address' => [
'street_line_1' => '<string>',
'city' => '<string>',
'country' => '<string>',
'street_line_2' => '<string>',
'subdivision' => '<string>',
'postal_code' => '<string>'
],
'birth_date' => '<string>',
'has_ownership' => true,
'has_control' => true,
'is_signer' => true,
'identifying_information' => [
[
'issuing_country' => '<string>',
'number' => '<string>',
'description' => '<string>',
'expiration' => '<string>',
'image_front' => '<string>',
'image_back' => '<string>'
]
],
'middle_name' => '<string>',
'transliterated_first_name' => '<string>',
'transliterated_middle_name' => '<string>',
'transliterated_last_name' => '<string>',
'phone' => '<string>',
'nationality' => '<string>',
'nationalities' => [
'<string>'
],
'place_of_birth' => [
'country' => '<string>',
'city' => '<string>'
],
'verified_database_at' => '2023-11-07T05:31:56Z',
'is_director' => true,
'title' => '<string>',
'ownership_percentage' => 123,
'attested_ownership_structure_at' => '<string>',
'verified_account_authorization_at' => '2023-11-07T05:31:56Z',
'relationship_established_at' => '<string>',
'verified_govid_at' => '2023-11-07T05:31:56Z',
'verified_selfie_at' => '2023-11-07T05:31:56Z',
'documents' => [
[
'purposes' => [
],
'file' => '<string>',
'description' => '<string>'
]
]
]),
CURLOPT_HTTPHEADER => [
"Api-Key: <api-key>",
"Content-Type: application/json"
],
]);
$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.bridge.xyz/v0/customers/{customerID}/associated_persons/{associatedPersonID}"
payload := strings.NewReader("{\n \"first_name\": \"<string>\",\n \"last_name\": \"<string>\",\n \"email\": \"<string>\",\n \"residential_address\": {\n \"street_line_1\": \"<string>\",\n \"city\": \"<string>\",\n \"country\": \"<string>\",\n \"street_line_2\": \"<string>\",\n \"subdivision\": \"<string>\",\n \"postal_code\": \"<string>\"\n },\n \"birth_date\": \"<string>\",\n \"has_ownership\": true,\n \"has_control\": true,\n \"is_signer\": true,\n \"identifying_information\": [\n {\n \"issuing_country\": \"<string>\",\n \"number\": \"<string>\",\n \"description\": \"<string>\",\n \"expiration\": \"<string>\",\n \"image_front\": \"<string>\",\n \"image_back\": \"<string>\"\n }\n ],\n \"middle_name\": \"<string>\",\n \"transliterated_first_name\": \"<string>\",\n \"transliterated_middle_name\": \"<string>\",\n \"transliterated_last_name\": \"<string>\",\n \"phone\": \"<string>\",\n \"nationality\": \"<string>\",\n \"nationalities\": [\n \"<string>\"\n ],\n \"place_of_birth\": {\n \"country\": \"<string>\",\n \"city\": \"<string>\"\n },\n \"verified_database_at\": \"2023-11-07T05:31:56Z\",\n \"is_director\": true,\n \"title\": \"<string>\",\n \"ownership_percentage\": 123,\n \"attested_ownership_structure_at\": \"<string>\",\n \"verified_account_authorization_at\": \"2023-11-07T05:31:56Z\",\n \"relationship_established_at\": \"<string>\",\n \"verified_govid_at\": \"2023-11-07T05:31:56Z\",\n \"verified_selfie_at\": \"2023-11-07T05:31:56Z\",\n \"documents\": [\n {\n \"purposes\": [],\n \"file\": \"<string>\",\n \"description\": \"<string>\"\n }\n ]\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("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.put("https://api.bridge.xyz/v0/customers/{customerID}/associated_persons/{associatedPersonID}")
.header("Api-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"first_name\": \"<string>\",\n \"last_name\": \"<string>\",\n \"email\": \"<string>\",\n \"residential_address\": {\n \"street_line_1\": \"<string>\",\n \"city\": \"<string>\",\n \"country\": \"<string>\",\n \"street_line_2\": \"<string>\",\n \"subdivision\": \"<string>\",\n \"postal_code\": \"<string>\"\n },\n \"birth_date\": \"<string>\",\n \"has_ownership\": true,\n \"has_control\": true,\n \"is_signer\": true,\n \"identifying_information\": [\n {\n \"issuing_country\": \"<string>\",\n \"number\": \"<string>\",\n \"description\": \"<string>\",\n \"expiration\": \"<string>\",\n \"image_front\": \"<string>\",\n \"image_back\": \"<string>\"\n }\n ],\n \"middle_name\": \"<string>\",\n \"transliterated_first_name\": \"<string>\",\n \"transliterated_middle_name\": \"<string>\",\n \"transliterated_last_name\": \"<string>\",\n \"phone\": \"<string>\",\n \"nationality\": \"<string>\",\n \"nationalities\": [\n \"<string>\"\n ],\n \"place_of_birth\": {\n \"country\": \"<string>\",\n \"city\": \"<string>\"\n },\n \"verified_database_at\": \"2023-11-07T05:31:56Z\",\n \"is_director\": true,\n \"title\": \"<string>\",\n \"ownership_percentage\": 123,\n \"attested_ownership_structure_at\": \"<string>\",\n \"verified_account_authorization_at\": \"2023-11-07T05:31:56Z\",\n \"relationship_established_at\": \"<string>\",\n \"verified_govid_at\": \"2023-11-07T05:31:56Z\",\n \"verified_selfie_at\": \"2023-11-07T05:31:56Z\",\n \"documents\": [\n {\n \"purposes\": [],\n \"file\": \"<string>\",\n \"description\": \"<string>\"\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bridge.xyz/v0/customers/{customerID}/associated_persons/{associatedPersonID}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Api-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"first_name\": \"<string>\",\n \"last_name\": \"<string>\",\n \"email\": \"<string>\",\n \"residential_address\": {\n \"street_line_1\": \"<string>\",\n \"city\": \"<string>\",\n \"country\": \"<string>\",\n \"street_line_2\": \"<string>\",\n \"subdivision\": \"<string>\",\n \"postal_code\": \"<string>\"\n },\n \"birth_date\": \"<string>\",\n \"has_ownership\": true,\n \"has_control\": true,\n \"is_signer\": true,\n \"identifying_information\": [\n {\n \"issuing_country\": \"<string>\",\n \"number\": \"<string>\",\n \"description\": \"<string>\",\n \"expiration\": \"<string>\",\n \"image_front\": \"<string>\",\n \"image_back\": \"<string>\"\n }\n ],\n \"middle_name\": \"<string>\",\n \"transliterated_first_name\": \"<string>\",\n \"transliterated_middle_name\": \"<string>\",\n \"transliterated_last_name\": \"<string>\",\n \"phone\": \"<string>\",\n \"nationality\": \"<string>\",\n \"nationalities\": [\n \"<string>\"\n ],\n \"place_of_birth\": {\n \"country\": \"<string>\",\n \"city\": \"<string>\"\n },\n \"verified_database_at\": \"2023-11-07T05:31:56Z\",\n \"is_director\": true,\n \"title\": \"<string>\",\n \"ownership_percentage\": 123,\n \"attested_ownership_structure_at\": \"<string>\",\n \"verified_account_authorization_at\": \"2023-11-07T05:31:56Z\",\n \"relationship_established_at\": \"<string>\",\n \"verified_govid_at\": \"2023-11-07T05:31:56Z\",\n \"verified_selfie_at\": \"2023-11-07T05:31:56Z\",\n \"documents\": [\n {\n \"purposes\": [],\n \"file\": \"<string>\",\n \"description\": \"<string>\"\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"id": "associated_person_1234567890",
"email": "associated_person@business.co",
"first_name": "John",
"last_name": "Smith",
"has_ownership": true,
"has_control": true,
"is_signer": true,
"title": "Chief Executive Officer",
"relationship_established_at": "2025-05-27T17:55:33.308Z",
"created_at": "2025-05-27T17:55:33.308Z",
"updated_at": "2025-05-27T17:55:33.308Z"
}
Authorizations
Path Parameters
A UUID that uniquely identifies a resource
Required string length:
1 - 42Pattern:
[a-z0-9]*Unique identifier for an associated person A UUID that uniquely identifies a resource
Required string length:
1 - 42Pattern:
[a-z0-9]*Body
application/json
Associated person data to update
The first name of the associated person
Required string length:
1 - 1024The last name of the associated person
Required string length:
2 - 1024The persons primary email address
Required string length:
1 - 1024The residential address of the associated person. This must be a physical address and cannot be a PO Box.
Show child attributes
Show child attributes
Date of birth in format yyyy-mm-dd. Must be at least 18 years old.
Required string length:
10True if this person has at least 25% ownership of the business.
True if this is the control person of the company, having significant responsibility to control, manage or influence the activities of the business entity. At least one control person must be specified.
True if this person is able to authorize transactions on behalf of the business. At least one signer must be specified.
Show child attributes
Show child attributes
The middle name of the associated person
Required string length:
1 - 1024Required when the first_name includes any non Latin-1 characters. Acceptable characters - Latin-1 Unicode Character Range: À-ÖØ-ßà-öø-ÿ; Standard Unicode Character Range: -~
Required string length:
1 - 256Required when the middle_name includes any non Latin-1 characters. Acceptable characters - Latin-1 Unicode Character Range: À-ÖØ-ßà-öø-ÿ; Standard Unicode Character Range: -~
Required string length:
1 - 256Required when the last_name includes any non Latin-1 characters. Acceptable characters - Latin-1 Unicode Character Range: À-ÖØ-ßà-öø-ÿ; Standard Unicode Character Range: -~
Required string length:
1 - 256The persons phone in format "+12223334444"
Required string length:
1 - 1024Required when any part of the residential_address includes any non Latin-1 characters. Acceptable characters - Latin-1 Unicode Character Range: À-ÖØ-ßà-öø-ÿ; Standard Unicode Character Range: -~
Show child attributes
Show child attributes
Legacy single nationality (ISO 3166-1 alpha-3). Prefer nationalities for all nationalities. See individual customer nationality / nationalities and EEA nationalities.
All nationalities for this associated person (ISO 3166-1 alpha-3). EEA / BBSA in-scope businesses: required on each UBO / associated person where policy applies.
Required string length:
3Country (and optionally city) of birth. EEA / BBSA in-scope customers: supply when onboarding individuals or associated persons under the EEA updated requirements. This is a sparse address — no street address. At least country should be present when the object is sent; city is recommended and will be required by EU law in 2027.
Show child attributes
Show child attributes
Write-only ISO 8601 timestamp. For EEA in-scope associated persons on reliance, second factor with verified_govid_at under TWO_FORMS_OF_ID_RELIANCE.
True if this person is an appointed director of the company. EEA / BBSA in-scope businesses: must be set for every associated person (complete director list). See EEA updated requirements.
The title of this associated person at the company, e.g. CEO, CFO, etc. Required if has_control is true.
Required string length:
1 - 1024Ultimate ownership percentage of the business. EEA / BBSA in-scope businesses: required when has_ownership is true for UBOs at or above the configured threshold (default 25%). See EEA updated requirements.
The date or timestamp when this individual attested to the correctness of the ownership structure provided to Bridge. If provided by at least one control person, ownership documents for the business are not required.
Write-only ISO 8601 timestamp. For EEA in-scope businesses on reliance, may satisfy signatory authority for signers who are not owner, director, or control person (signature_authority_requirement(for_reliance: true)); alternative is documents with purpose proof_of_signatory_authority. See EEA updated requirements — LOA.
The date or timestamp when the associated person relationship was established in format yyyy-mm-dd.
Write-only ISO 8601 timestamp. For EEA in-scope associated persons on reliance, use with verified_selfie_at or verified_database_at under TWO_FORMS_OF_ID_RELIANCE.
Write-only ISO 8601 timestamp. For EEA in-scope associated persons on reliance, pairs with verified_govid_at or verified_database_at under TWO_FORMS_OF_ID_RELIANCE.
Please click "ADD OBJECT" for more information.
Show child attributes
Show child attributes
Response
Updated associated person
Unique identifier for the associated person
Created timestamp in milliseconds since Unix epoch
Last updated timestamp in milliseconds since Unix epoch
The email address of the associated person
The first name of the associated person
Required string length:
2 - 1024The last name of the associated person
Required string length:
2 - 1024True if this person has at least 25% ownership of the business.
True if this is the control person of the company, having significant responsibility to control, manage or influence the activities of the business entity.
True if this person is able to authorize transactions on behalf of the business.
The title of this associated person at the company, e.g. CEO, CFO, etc.
When this individual attested to the correctness of the ownership structure provided to Bridge. If provided by at least one control person, ownership documents for the business are not required.
When the associated person relationship was established in format yyyy-mm-dd.
Was this page helpful?