Skip to main content
PUT
Update individual application details

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 250 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:
ā€‹
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:
ā€‹
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:
ā€‹
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:

Response

Individual application details updated successfully

Response containing individual entity data

ā€‹
application_id
string
required

The application ID

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

"1NFHrqBHb3cTfLVkFSGmHZqdDPi"

ā€‹
application_status
enum<string>
required

Current status of the application

Available options:
pending,
submitted,
under_review,
request_for_information,
admin_revision,
approved,
declined,
completed,
compliance_review
Example:

"submitted"

ā€‹
individual
object
required

The individual entity data

ā€‹
application_decision
enum<string> | null

Decision outcome (if any)

Available options:
approved,
declined,
withdrawn