CLI
# Requires: npm i -g @infinite_dev/cli && export INFINITE_API_KEY=sk_sandbox_...
# Escape hatch for any endpoint: infinite api <METHOD> <path>
infinite api POST /v1/customers/cus_abc123/associated_individuals \
--body '<request-json>'Create a new associated individual (cus_abc123).
# Infinite MCP is read-only for this endpoint — use a dedicated MCP tool when one exists, otherwise run the CLI tab.import requests
url = "https://sandbox.api.infinite.dev/v1/customers/{customerId}/associated_individuals"
payload = {
"countryCode": "US",
"hasOwnership": True,
"hasControl": True,
"firstName": "John",
"lastName": "Doe",
"parentEntityId": "asp_abc123",
"email": "<string>",
"phone": "<string>",
"ownershipPercentage": 50,
"isSigner": True,
"isDirector": True,
"attestedOwnershipStructureAt": "2026-06-01T10:45:05Z",
"relationshipDate": "2020-01-15",
"generateVerificationLink": True,
"sendInvite": True,
"middleName": "<string>",
"nickname": "<string>",
"dateOfBirth": "1990-01-15",
"taxResidenceCountry": "GB",
"taxIdentificationNumber": "<string>",
"taxIdentificationDocumentType": "UTR",
"transliteratedFirstName": "<string>",
"transliteratedMiddleName": "<string>",
"transliteratedLastName": "<string>",
"supportingDocuments": [
{
"file": "doc_abc123",
"requirementId": "<string>",
"type": "PROOF_OF_ADDRESS",
"subtype": "UTILITY_BILL",
"description": "Passport issued in 2020",
"remarks": "Uploaded to support proof of business address"
}
]
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
countryCode: 'US',
hasOwnership: true,
hasControl: true,
firstName: 'John',
lastName: 'Doe',
parentEntityId: 'asp_abc123',
email: '<string>',
phone: '<string>',
ownershipPercentage: 50,
isSigner: true,
isDirector: true,
attestedOwnershipStructureAt: '2026-06-01T10:45:05Z',
relationshipDate: '2020-01-15',
generateVerificationLink: true,
sendInvite: true,
middleName: '<string>',
nickname: '<string>',
dateOfBirth: '1990-01-15',
taxResidenceCountry: 'GB',
taxIdentificationNumber: '<string>',
taxIdentificationDocumentType: 'UTR',
transliteratedFirstName: '<string>',
transliteratedMiddleName: '<string>',
transliteratedLastName: '<string>',
supportingDocuments: [
{
file: 'doc_abc123',
requirementId: '<string>',
type: 'PROOF_OF_ADDRESS',
subtype: 'UTILITY_BILL',
description: 'Passport issued in 2020',
remarks: 'Uploaded to support proof of business address'
}
]
})
};
fetch('https://sandbox.api.infinite.dev/v1/customers/{customerId}/associated_individuals', 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://sandbox.api.infinite.dev/v1/customers/{customerId}/associated_individuals",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'countryCode' => 'US',
'hasOwnership' => true,
'hasControl' => true,
'firstName' => 'John',
'lastName' => 'Doe',
'parentEntityId' => 'asp_abc123',
'email' => '<string>',
'phone' => '<string>',
'ownershipPercentage' => 50,
'isSigner' => true,
'isDirector' => true,
'attestedOwnershipStructureAt' => '2026-06-01T10:45:05Z',
'relationshipDate' => '2020-01-15',
'generateVerificationLink' => true,
'sendInvite' => true,
'middleName' => '<string>',
'nickname' => '<string>',
'dateOfBirth' => '1990-01-15',
'taxResidenceCountry' => 'GB',
'taxIdentificationNumber' => '<string>',
'taxIdentificationDocumentType' => 'UTR',
'transliteratedFirstName' => '<string>',
'transliteratedMiddleName' => '<string>',
'transliteratedLastName' => '<string>',
'supportingDocuments' => [
[
'file' => 'doc_abc123',
'requirementId' => '<string>',
'type' => 'PROOF_OF_ADDRESS',
'subtype' => 'UTILITY_BILL',
'description' => 'Passport issued in 2020',
'remarks' => 'Uploaded to support proof of business address'
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"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://sandbox.api.infinite.dev/v1/customers/{customerId}/associated_individuals"
payload := strings.NewReader("{\n \"countryCode\": \"US\",\n \"hasOwnership\": true,\n \"hasControl\": true,\n \"firstName\": \"John\",\n \"lastName\": \"Doe\",\n \"parentEntityId\": \"asp_abc123\",\n \"email\": \"<string>\",\n \"phone\": \"<string>\",\n \"ownershipPercentage\": 50,\n \"isSigner\": true,\n \"isDirector\": true,\n \"attestedOwnershipStructureAt\": \"2026-06-01T10:45:05Z\",\n \"relationshipDate\": \"2020-01-15\",\n \"generateVerificationLink\": true,\n \"sendInvite\": true,\n \"middleName\": \"<string>\",\n \"nickname\": \"<string>\",\n \"dateOfBirth\": \"1990-01-15\",\n \"taxResidenceCountry\": \"GB\",\n \"taxIdentificationNumber\": \"<string>\",\n \"taxIdentificationDocumentType\": \"UTR\",\n \"transliteratedFirstName\": \"<string>\",\n \"transliteratedMiddleName\": \"<string>\",\n \"transliteratedLastName\": \"<string>\",\n \"supportingDocuments\": [\n {\n \"file\": \"doc_abc123\",\n \"requirementId\": \"<string>\",\n \"type\": \"PROOF_OF_ADDRESS\",\n \"subtype\": \"UTILITY_BILL\",\n \"description\": \"Passport issued in 2020\",\n \"remarks\": \"Uploaded to support proof of business address\"\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
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.post("https://sandbox.api.infinite.dev/v1/customers/{customerId}/associated_individuals")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"countryCode\": \"US\",\n \"hasOwnership\": true,\n \"hasControl\": true,\n \"firstName\": \"John\",\n \"lastName\": \"Doe\",\n \"parentEntityId\": \"asp_abc123\",\n \"email\": \"<string>\",\n \"phone\": \"<string>\",\n \"ownershipPercentage\": 50,\n \"isSigner\": true,\n \"isDirector\": true,\n \"attestedOwnershipStructureAt\": \"2026-06-01T10:45:05Z\",\n \"relationshipDate\": \"2020-01-15\",\n \"generateVerificationLink\": true,\n \"sendInvite\": true,\n \"middleName\": \"<string>\",\n \"nickname\": \"<string>\",\n \"dateOfBirth\": \"1990-01-15\",\n \"taxResidenceCountry\": \"GB\",\n \"taxIdentificationNumber\": \"<string>\",\n \"taxIdentificationDocumentType\": \"UTR\",\n \"transliteratedFirstName\": \"<string>\",\n \"transliteratedMiddleName\": \"<string>\",\n \"transliteratedLastName\": \"<string>\",\n \"supportingDocuments\": [\n {\n \"file\": \"doc_abc123\",\n \"requirementId\": \"<string>\",\n \"type\": \"PROOF_OF_ADDRESS\",\n \"subtype\": \"UTILITY_BILL\",\n \"description\": \"Passport issued in 2020\",\n \"remarks\": \"Uploaded to support proof of business address\"\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://sandbox.api.infinite.dev/v1/customers/{customerId}/associated_individuals")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"countryCode\": \"US\",\n \"hasOwnership\": true,\n \"hasControl\": true,\n \"firstName\": \"John\",\n \"lastName\": \"Doe\",\n \"parentEntityId\": \"asp_abc123\",\n \"email\": \"<string>\",\n \"phone\": \"<string>\",\n \"ownershipPercentage\": 50,\n \"isSigner\": true,\n \"isDirector\": true,\n \"attestedOwnershipStructureAt\": \"2026-06-01T10:45:05Z\",\n \"relationshipDate\": \"2020-01-15\",\n \"generateVerificationLink\": true,\n \"sendInvite\": true,\n \"middleName\": \"<string>\",\n \"nickname\": \"<string>\",\n \"dateOfBirth\": \"1990-01-15\",\n \"taxResidenceCountry\": \"GB\",\n \"taxIdentificationNumber\": \"<string>\",\n \"taxIdentificationDocumentType\": \"UTR\",\n \"transliteratedFirstName\": \"<string>\",\n \"transliteratedMiddleName\": \"<string>\",\n \"transliteratedLastName\": \"<string>\",\n \"supportingDocuments\": [\n {\n \"file\": \"doc_abc123\",\n \"requirementId\": \"<string>\",\n \"type\": \"PROOF_OF_ADDRESS\",\n \"subtype\": \"UTILITY_BILL\",\n \"description\": \"Passport issued in 2020\",\n \"remarks\": \"Uploaded to support proof of business address\"\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"id": "asp_abc123",
"createdAt": "2026-01-15T10:30:00Z",
"updatedAt": "2026-01-15T10:30:00Z",
"entityType": "BUSINESS",
"hasOwnership": true,
"hasControl": true,
"parentEntityId": "asp_parent123",
"details": {
"firstName": "John",
"nickname": "Johnny",
"lastName": "Doe",
"middleName": "Michael",
"dateOfBirth": "1985-03-15",
"taxResidenceCountry": "GB",
"transliteratedFirstName": "<string>",
"transliteratedMiddleName": "<string>",
"transliteratedLastName": "<string>",
"taxIdentificationDocumentType": "UTR"
},
"countryCode": "US",
"email": "contact@acmeholdings.com",
"phone": "+14155551234",
"address": {
"addressLine1": "123 Main Street",
"city": "San Francisco",
"postalCode": "94102",
"country": "US",
"addressLine2": "Apt 4B",
"state": "CA",
"transliterated": {
"addressLine1": "123 Main Street",
"addressLine2": "Apt 4B",
"city": "Beijing",
"state": "Hebei"
}
},
"ownershipPercentage": 51,
"isSigner": false,
"isDirector": false,
"role": "CEO",
"title": "Managing Director",
"documents": [
"doc_abc123"
],
"attestedOwnershipStructureAt": "2026-01-15T10:30:00Z",
"displayName": "Acme Holdings LLC",
"verificationLink": {
"sessionId": "vsess_abc123",
"verificationUrl": "https://verify.infinite.dev/?sessionId=vsess_abc123",
"expiresAt": "2026-01-09T10:30:00Z",
"status": "ACTIVE"
}
}Business Onboarding
Create a new associated individual
Create an individual associated entity for a business customer using a flat request body. Use this endpoint for UBOs, control persons, and signers.
POST
/
v1
/
customers
/
{customerId}
/
associated_individuals
CLI
# Requires: npm i -g @infinite_dev/cli && export INFINITE_API_KEY=sk_sandbox_...
# Escape hatch for any endpoint: infinite api <METHOD> <path>
infinite api POST /v1/customers/cus_abc123/associated_individuals \
--body '<request-json>'Create a new associated individual (cus_abc123).
# Infinite MCP is read-only for this endpoint — use a dedicated MCP tool when one exists, otherwise run the CLI tab.import requests
url = "https://sandbox.api.infinite.dev/v1/customers/{customerId}/associated_individuals"
payload = {
"countryCode": "US",
"hasOwnership": True,
"hasControl": True,
"firstName": "John",
"lastName": "Doe",
"parentEntityId": "asp_abc123",
"email": "<string>",
"phone": "<string>",
"ownershipPercentage": 50,
"isSigner": True,
"isDirector": True,
"attestedOwnershipStructureAt": "2026-06-01T10:45:05Z",
"relationshipDate": "2020-01-15",
"generateVerificationLink": True,
"sendInvite": True,
"middleName": "<string>",
"nickname": "<string>",
"dateOfBirth": "1990-01-15",
"taxResidenceCountry": "GB",
"taxIdentificationNumber": "<string>",
"taxIdentificationDocumentType": "UTR",
"transliteratedFirstName": "<string>",
"transliteratedMiddleName": "<string>",
"transliteratedLastName": "<string>",
"supportingDocuments": [
{
"file": "doc_abc123",
"requirementId": "<string>",
"type": "PROOF_OF_ADDRESS",
"subtype": "UTILITY_BILL",
"description": "Passport issued in 2020",
"remarks": "Uploaded to support proof of business address"
}
]
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
countryCode: 'US',
hasOwnership: true,
hasControl: true,
firstName: 'John',
lastName: 'Doe',
parentEntityId: 'asp_abc123',
email: '<string>',
phone: '<string>',
ownershipPercentage: 50,
isSigner: true,
isDirector: true,
attestedOwnershipStructureAt: '2026-06-01T10:45:05Z',
relationshipDate: '2020-01-15',
generateVerificationLink: true,
sendInvite: true,
middleName: '<string>',
nickname: '<string>',
dateOfBirth: '1990-01-15',
taxResidenceCountry: 'GB',
taxIdentificationNumber: '<string>',
taxIdentificationDocumentType: 'UTR',
transliteratedFirstName: '<string>',
transliteratedMiddleName: '<string>',
transliteratedLastName: '<string>',
supportingDocuments: [
{
file: 'doc_abc123',
requirementId: '<string>',
type: 'PROOF_OF_ADDRESS',
subtype: 'UTILITY_BILL',
description: 'Passport issued in 2020',
remarks: 'Uploaded to support proof of business address'
}
]
})
};
fetch('https://sandbox.api.infinite.dev/v1/customers/{customerId}/associated_individuals', 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://sandbox.api.infinite.dev/v1/customers/{customerId}/associated_individuals",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'countryCode' => 'US',
'hasOwnership' => true,
'hasControl' => true,
'firstName' => 'John',
'lastName' => 'Doe',
'parentEntityId' => 'asp_abc123',
'email' => '<string>',
'phone' => '<string>',
'ownershipPercentage' => 50,
'isSigner' => true,
'isDirector' => true,
'attestedOwnershipStructureAt' => '2026-06-01T10:45:05Z',
'relationshipDate' => '2020-01-15',
'generateVerificationLink' => true,
'sendInvite' => true,
'middleName' => '<string>',
'nickname' => '<string>',
'dateOfBirth' => '1990-01-15',
'taxResidenceCountry' => 'GB',
'taxIdentificationNumber' => '<string>',
'taxIdentificationDocumentType' => 'UTR',
'transliteratedFirstName' => '<string>',
'transliteratedMiddleName' => '<string>',
'transliteratedLastName' => '<string>',
'supportingDocuments' => [
[
'file' => 'doc_abc123',
'requirementId' => '<string>',
'type' => 'PROOF_OF_ADDRESS',
'subtype' => 'UTILITY_BILL',
'description' => 'Passport issued in 2020',
'remarks' => 'Uploaded to support proof of business address'
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"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://sandbox.api.infinite.dev/v1/customers/{customerId}/associated_individuals"
payload := strings.NewReader("{\n \"countryCode\": \"US\",\n \"hasOwnership\": true,\n \"hasControl\": true,\n \"firstName\": \"John\",\n \"lastName\": \"Doe\",\n \"parentEntityId\": \"asp_abc123\",\n \"email\": \"<string>\",\n \"phone\": \"<string>\",\n \"ownershipPercentage\": 50,\n \"isSigner\": true,\n \"isDirector\": true,\n \"attestedOwnershipStructureAt\": \"2026-06-01T10:45:05Z\",\n \"relationshipDate\": \"2020-01-15\",\n \"generateVerificationLink\": true,\n \"sendInvite\": true,\n \"middleName\": \"<string>\",\n \"nickname\": \"<string>\",\n \"dateOfBirth\": \"1990-01-15\",\n \"taxResidenceCountry\": \"GB\",\n \"taxIdentificationNumber\": \"<string>\",\n \"taxIdentificationDocumentType\": \"UTR\",\n \"transliteratedFirstName\": \"<string>\",\n \"transliteratedMiddleName\": \"<string>\",\n \"transliteratedLastName\": \"<string>\",\n \"supportingDocuments\": [\n {\n \"file\": \"doc_abc123\",\n \"requirementId\": \"<string>\",\n \"type\": \"PROOF_OF_ADDRESS\",\n \"subtype\": \"UTILITY_BILL\",\n \"description\": \"Passport issued in 2020\",\n \"remarks\": \"Uploaded to support proof of business address\"\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
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.post("https://sandbox.api.infinite.dev/v1/customers/{customerId}/associated_individuals")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"countryCode\": \"US\",\n \"hasOwnership\": true,\n \"hasControl\": true,\n \"firstName\": \"John\",\n \"lastName\": \"Doe\",\n \"parentEntityId\": \"asp_abc123\",\n \"email\": \"<string>\",\n \"phone\": \"<string>\",\n \"ownershipPercentage\": 50,\n \"isSigner\": true,\n \"isDirector\": true,\n \"attestedOwnershipStructureAt\": \"2026-06-01T10:45:05Z\",\n \"relationshipDate\": \"2020-01-15\",\n \"generateVerificationLink\": true,\n \"sendInvite\": true,\n \"middleName\": \"<string>\",\n \"nickname\": \"<string>\",\n \"dateOfBirth\": \"1990-01-15\",\n \"taxResidenceCountry\": \"GB\",\n \"taxIdentificationNumber\": \"<string>\",\n \"taxIdentificationDocumentType\": \"UTR\",\n \"transliteratedFirstName\": \"<string>\",\n \"transliteratedMiddleName\": \"<string>\",\n \"transliteratedLastName\": \"<string>\",\n \"supportingDocuments\": [\n {\n \"file\": \"doc_abc123\",\n \"requirementId\": \"<string>\",\n \"type\": \"PROOF_OF_ADDRESS\",\n \"subtype\": \"UTILITY_BILL\",\n \"description\": \"Passport issued in 2020\",\n \"remarks\": \"Uploaded to support proof of business address\"\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://sandbox.api.infinite.dev/v1/customers/{customerId}/associated_individuals")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"countryCode\": \"US\",\n \"hasOwnership\": true,\n \"hasControl\": true,\n \"firstName\": \"John\",\n \"lastName\": \"Doe\",\n \"parentEntityId\": \"asp_abc123\",\n \"email\": \"<string>\",\n \"phone\": \"<string>\",\n \"ownershipPercentage\": 50,\n \"isSigner\": true,\n \"isDirector\": true,\n \"attestedOwnershipStructureAt\": \"2026-06-01T10:45:05Z\",\n \"relationshipDate\": \"2020-01-15\",\n \"generateVerificationLink\": true,\n \"sendInvite\": true,\n \"middleName\": \"<string>\",\n \"nickname\": \"<string>\",\n \"dateOfBirth\": \"1990-01-15\",\n \"taxResidenceCountry\": \"GB\",\n \"taxIdentificationNumber\": \"<string>\",\n \"taxIdentificationDocumentType\": \"UTR\",\n \"transliteratedFirstName\": \"<string>\",\n \"transliteratedMiddleName\": \"<string>\",\n \"transliteratedLastName\": \"<string>\",\n \"supportingDocuments\": [\n {\n \"file\": \"doc_abc123\",\n \"requirementId\": \"<string>\",\n \"type\": \"PROOF_OF_ADDRESS\",\n \"subtype\": \"UTILITY_BILL\",\n \"description\": \"Passport issued in 2020\",\n \"remarks\": \"Uploaded to support proof of business address\"\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"id": "asp_abc123",
"createdAt": "2026-01-15T10:30:00Z",
"updatedAt": "2026-01-15T10:30:00Z",
"entityType": "BUSINESS",
"hasOwnership": true,
"hasControl": true,
"parentEntityId": "asp_parent123",
"details": {
"firstName": "John",
"nickname": "Johnny",
"lastName": "Doe",
"middleName": "Michael",
"dateOfBirth": "1985-03-15",
"taxResidenceCountry": "GB",
"transliteratedFirstName": "<string>",
"transliteratedMiddleName": "<string>",
"transliteratedLastName": "<string>",
"taxIdentificationDocumentType": "UTR"
},
"countryCode": "US",
"email": "contact@acmeholdings.com",
"phone": "+14155551234",
"address": {
"addressLine1": "123 Main Street",
"city": "San Francisco",
"postalCode": "94102",
"country": "US",
"addressLine2": "Apt 4B",
"state": "CA",
"transliterated": {
"addressLine1": "123 Main Street",
"addressLine2": "Apt 4B",
"city": "Beijing",
"state": "Hebei"
}
},
"ownershipPercentage": 51,
"isSigner": false,
"isDirector": false,
"role": "CEO",
"title": "Managing Director",
"documents": [
"doc_abc123"
],
"attestedOwnershipStructureAt": "2026-01-15T10:30:00Z",
"displayName": "Acme Holdings LLC",
"verificationLink": {
"sessionId": "vsess_abc123",
"verificationUrl": "https://verify.infinite.dev/?sessionId=vsess_abc123",
"expiresAt": "2026-01-09T10:30:00Z",
"status": "ACTIVE"
}
}Authorizations
API Key in Bearer format (e.g., Bearer sk_test_...)
Headers
API key
Idempotency key for preventing duplicate requests
Path Parameters
An ID that uniquely identifies a customer resource
Example:
"cus_1234567890abcdef"
Body
application/json
New associated individual to be created
Country code (ISO 3166-1 alpha-2). Nationality for individuals, country of incorporation for businesses.
Example:
"US"
Whether this entity is an owner. For an individual with indirect ownership whose percentage is not quantified, omit ownershipPercentage and set this to true to identify them as a beneficial owner.
Has significant control (e.g. CEO, managing member). A control person satisfies the business submission requirement when no individual holds 25% or more effective ownership.
First name
Example:
"John"
Last name
Example:
"Doe"
Parent entity ID for nested ownership. Use the associated business entity ID returned from the associated entity endpoints when linking a child owner beneath an intermediate business owner.
Example:
"asp_abc123"
Email address. Required when generateVerificationLink is true.
Phone number
Address. Use the nested transliterated field for Latin character versions of non-Latin addresses.
Show child attributes
Show child attributes
Ownership percentage
Required range:
0 <= x <= 100Has signing authority
Is a director
Structured role at the company.
Available options:
CEO, CFO, COO, PRESIDENT, GENERAL_COUNSEL, MANAGING_MEMBER, TREASURER, OTHER Timestamp when ownership structure was attested
Example:
"2026-06-01T10:45:05Z"
Date when the relationship with this entity was established (YYYY-MM-DD).
Example:
"2020-01-15"
When true, generates a verification link for this UBO to complete their KYC. The link will be returned in the response.
Example:
true
When true (and generateVerificationLink is also true), sends an email invitation to the UBO to complete their KYC verification.
Example:
true
Middle name
Nickname
Date of birth (YYYY-MM-DD)
Example:
"1990-01-15"
Optional. Country of tax residence (ISO 3166-1 alpha-2). Provide only when it differs from nationality; tax ID format validation falls back to nationality when omitted.
Example:
"GB"
Tax identification number. Validated against country-specific formats when provided.
Tax identification document type when the issuing country supports multiple tax ID types.
Example:
"UTR"
Transliterated first name
Transliterated middle name
Transliterated last name
Government ID document references
Show child attributes
Show child attributes
Proof of address document reference
Show child attributes
Show child attributes
Supporting document references
Show child attributes
Show child attributes
Response
Associated individual created successfully
Unique identifier
Example:
"asp_abc123"
Created timestamp
Example:
"2026-01-15T10:30:00Z"
Last updated timestamp
Example:
"2026-01-15T10:30:00Z"
Type of entity
Available options:
INDIVIDUAL, BUSINESS Example:
"BUSINESS"
Whether this entity is an owner. For an individual with indirect ownership whose percentage is not quantified, omit ownershipPercentage and set this to true to identify them as a beneficial owner.
Example:
true
Has significant control (e.g. CEO, managing member). A control person satisfies the business submission requirement when no individual holds 25% or more effective ownership.
Example:
true
Parent entity ID for nested ownership. Use the associated business entity ID returned from the associated entity endpoints when linking a child owner beneath an intermediate business owner.
Example:
"asp_parent123"
Type-specific details (individual or business)
- Option 1
- Option 2
Show child attributes
Show child attributes
Country code (ISO 3166-1 alpha-2)
Example:
"US"
Email address
Example:
"contact@acmeholdings.com"
Phone number
Example:
"+14155551234"
Address. Use the nested transliterated field for Latin character versions of non-Latin addresses.
Show child attributes
Show child attributes
Ownership percentage
Example:
51
Has signing authority
Example:
false
Is a director
Example:
false
Structured role at the company.
Available options:
CEO, CFO, COO, PRESIDENT, GENERAL_COUNSEL, MANAGING_MEMBER, TREASURER, OTHER Custom title at the company.
Example:
"Managing Director"
Array of document IDs
Example:
["doc_abc123"]
Timestamp when ownership structure was attested
Example:
"2026-01-15T10:30:00Z"
Display name
Example:
"Acme Holdings LLC"
Verification link for UBO KYC. Present on create (when generateVerificationLink is true) and on single entity GET if there is an active/pending verification session.
Show child attributes
Show child attributes
Was this page helpful?