Skip to main content
POST
/
applications
/
{application_id}
/
associated-individuals
Add associated individual to business application
curl --request POST \
  --url https://api.platform.dakota.xyz/applications/{application_id}/associated-individuals \
  --header 'Content-Type: application/json' \
  --header 'X-Application-Token: <api-key>' \
  --header 'x-idempotency-key: <x-idempotency-key>' \
  --data '
{
  "roles": [
    "ubo",
    "control_person"
  ],
  "name": {
    "first": "John",
    "middle": "Michael",
    "last": "Doe"
  },
  "title": "ceo",
  "employment_status": "employed",
  "ownership_percentage": 25.5,
  "date_of_birth": "1985-06-15",
  "ssn": "123-45-6789",
  "nationalities": [
    "US"
  ],
  "address": {
    "street1": "123 Main St",
    "street2": "Apt 4B",
    "street3": "Building C",
    "city": "San Francisco",
    "region": "California",
    "postal_code": "94105",
    "country": "US"
  },
  "email_address": "john.doe@acme.com",
  "purpose_of_account": [
    "investing",
    "storage_of_funds_or_digital_assets"
  ],
  "source_of_wealth": [
    "employment",
    "savings"
  ]
}
'
{
  "id": "1NFHrqBHb3cTfLVkFSGmHZqdDPi"
}

Authorizations

​
X-Application-Token
string
header
required

Application-specific token for public URL access. Generated when a customer is created. Provides access to a single application without requiring an API key. Token is valid for 30 days and rate-limited to 100 requests per hour.

Headers

​
x-idempotency-key
string<uuid>
required

Unique key to ensure request idempotency. If the same key is used within a certain time window, the original response will be returned instead of executing the request again.

Path Parameters

​
application_id
string
required

KSUID is a 27-character globally unique ID that combines a timestamp with a random component. Used for all entity identifiers in the Dakota platform.

Required string length: 27
Pattern: ^[0-9A-Za-z]{27}$
Example:

"1NFHrqBHb3cTfLVkFSGmHZqdDPi"

Body

application/json

An individual person (used for both business associated persons and standalone individual applications)

​
roles
enum<string>[]
required

Role(s) of this person (individual cannot be combined with other types)

Minimum array length: 1
Available options:
ubo,
control_person,
applicant,
individual
Example:
["ubo", "control_person"]
​
name
object
required

Full name of a person

​
date_of_birth
string<date>
required

Date of birth (ISO 8601 format, person must be at least 18 years old)

Example:

"1985-06-15"

​
nationalities
string[]
required

ISO 3166-1 alpha-2 country codes for nationalities

Minimum array length: 1
Required string length: 2
Example:
["US"]
​
address
Address · object
required

Standardized physical address format used throughout the Dakota platform for user and entity addresses.

​
email_address
string<email>
required

Email address (cannot use example or test domains)

Example:

"john.doe@acme.com"

​
title
enum<string>

Job title (required for UBO/control person, optional for applicant, invalid for individual)

Available options:
ceo,
coo,
cfo,
cto,
cco,
director,
other_officer
Example:

"ceo"

​
employment_status
enum<string>

Employment status (required only when roles includes 'individual')

Available options:
employed,
self_employed,
unemployed,
student,
retired
Example:

"employed"

​
ownership_percentage
number<double>

Ownership percentage (required for UBO role, optional for others, must be > 0 and <= 100)

Required range: 0.01 <= x <= 100
Example:

25.5

​
ssn
string

Social Security Number (required for US persons, format: XXX-XX-XXXX)

Pattern: ^\d{3}-\d{2}-\d{4}$
Example:

"123-45-6789"

​
purpose_of_account
enum<string>[]

Intended purposes for the account (required when roles includes 'individual')

Minimum array length: 1
Available options:
investing,
sending_and_receiving_payments,
storage_of_funds_or_digital_assets,
making_online_payments,
trading_on_other_platforms
Example:
[
  "investing",
  "storage_of_funds_or_digital_assets"
]
​
source_of_wealth
enum<string>[]

Sources of wealth (required when roles includes 'individual')

Minimum array length: 1
Available options:
investments,
employment,
court_settlement,
lottery_winnings,
retirement_income,
savings,
sale_of_assets,
family_funds,
gambling_winnings,
gift,
inheritance,
insurance_claim,
loan,
redundancy_severance,
benefits
Example:
["employment", "savings"]

Response

Individual added successfully

​
id
string
required

KSUID is a 27-character globally unique ID that combines a timestamp with a random component. Used for all entity identifiers in the Dakota platform.

Required string length: 27
Pattern: ^[0-9A-Za-z]{27}$
Example:

"1NFHrqBHb3cTfLVkFSGmHZqdDPi"