Get details of a single associated person
curl --request GET \
--url https://api.byzantine.fi/v1/query/get-associated-person-details \
--header 'X-Pubkey: <x-pubkey>' \
--header 'X-Pubkey, X-Timestamp, X-Signature: <api-key>' \
--header 'X-Signature: <x-signature>' \
--header 'X-Timestamp: <x-timestamp>'import requests
url = "https://api.byzantine.fi/v1/query/get-associated-person-details"
headers = {
"X-Pubkey": "<x-pubkey>",
"X-Timestamp": "<x-timestamp>",
"X-Signature": "<x-signature>",
"X-Pubkey, X-Timestamp, X-Signature": "<api-key>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {
'X-Pubkey': '<x-pubkey>',
'X-Timestamp': '<x-timestamp>',
'X-Signature': '<x-signature>',
'X-Pubkey, X-Timestamp, X-Signature': '<api-key>'
}
};
fetch('https://api.byzantine.fi/v1/query/get-associated-person-details', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"beneficiaryId": "550e8400-e29b-41d4-a716-446655440000",
"verificationStatus": "active",
"userInfo": {
"firstName": "John",
"lastName": "Smith",
"email": "john.smith@example.com",
"middleName": "William",
"phone": "+33 123 456 789",
"birthDate": "1990-01-01",
"nationality": "FRA",
"nationalities": [
"FRA",
"USA"
],
"countryOfBirth": "FRA",
"cityOfBirth": "Paris",
"residentialAddress": {
"streetLine1": "33 Rue La Fayette",
"city": "Paris",
"postalCode": "75009",
"country": "FRA",
"streetLine2": "WeWork",
"state": "IDF"
},
"socialSecurityNumber": "123-45-6789",
"profilePictureUrl": "<string>"
},
"beneficiaryDetails": {
"beneficiaryType": [
"ubo"
],
"title": "CEO",
"ownershipPercentage": 32.5,
"isSigner": true
},
"verificationDocuments": [
{
"documentType": "passport",
"issuingCountry": "FRA",
"documentId": "830c219c-d197-451d-b879-77936a80c452",
"documentNumber": "FR1234567890",
"description": "Additional supporting document",
"issuedAt": "2026-01-15",
"expiresAt": "2031-01-14",
"warnings": [
"<string>"
],
"errors": [
"<string>"
]
}
],
"missingDocuments": [
"<string>"
]
}Customer management
Get details of a single associated person
This endpoint returns the full record of one beneficiary or representative of an entity:
- Personal information (name, contact, birth details, residential address)
- Beneficiary details (type, title held at the business, ownership share)
- Verification status and the documents still missing
The beneficiaryId is returned by get-entity-details and by the associated person submit
endpoints. A person belonging to another integrator returns the same 404 as one that does
not exist, so this endpoint never reveals the existence of a foreign record.
GET
/
v1
/
query
/
get-associated-person-details
Get details of a single associated person
curl --request GET \
--url https://api.byzantine.fi/v1/query/get-associated-person-details \
--header 'X-Pubkey: <x-pubkey>' \
--header 'X-Pubkey, X-Timestamp, X-Signature: <api-key>' \
--header 'X-Signature: <x-signature>' \
--header 'X-Timestamp: <x-timestamp>'import requests
url = "https://api.byzantine.fi/v1/query/get-associated-person-details"
headers = {
"X-Pubkey": "<x-pubkey>",
"X-Timestamp": "<x-timestamp>",
"X-Signature": "<x-signature>",
"X-Pubkey, X-Timestamp, X-Signature": "<api-key>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {
'X-Pubkey': '<x-pubkey>',
'X-Timestamp': '<x-timestamp>',
'X-Signature': '<x-signature>',
'X-Pubkey, X-Timestamp, X-Signature': '<api-key>'
}
};
fetch('https://api.byzantine.fi/v1/query/get-associated-person-details', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"beneficiaryId": "550e8400-e29b-41d4-a716-446655440000",
"verificationStatus": "active",
"userInfo": {
"firstName": "John",
"lastName": "Smith",
"email": "john.smith@example.com",
"middleName": "William",
"phone": "+33 123 456 789",
"birthDate": "1990-01-01",
"nationality": "FRA",
"nationalities": [
"FRA",
"USA"
],
"countryOfBirth": "FRA",
"cityOfBirth": "Paris",
"residentialAddress": {
"streetLine1": "33 Rue La Fayette",
"city": "Paris",
"postalCode": "75009",
"country": "FRA",
"streetLine2": "WeWork",
"state": "IDF"
},
"socialSecurityNumber": "123-45-6789",
"profilePictureUrl": "<string>"
},
"beneficiaryDetails": {
"beneficiaryType": [
"ubo"
],
"title": "CEO",
"ownershipPercentage": 32.5,
"isSigner": true
},
"verificationDocuments": [
{
"documentType": "passport",
"issuingCountry": "FRA",
"documentId": "830c219c-d197-451d-b879-77936a80c452",
"documentNumber": "FR1234567890",
"description": "Additional supporting document",
"issuedAt": "2026-01-15",
"expiresAt": "2031-01-14",
"warnings": [
"<string>"
],
"errors": [
"<string>"
]
}
],
"missingDocuments": [
"<string>"
]
}Headers
Query Parameters
Response
Associated person retrieved successfully
Response body for an associated person

