Skip to main content
PUT
/
applications
/
{application_id}
/
individual-details
Update individual application details
curl --request PUT \
  --url https://api.platform.dakota.xyz/applications/{application_id}/individual-details \
  --header 'Content-Type: application/json' \
  --header 'X-Application-Token: <api-key>' \
  --data '
{
  "roles": [
    "ubo",
    "control_person"
  ],
  "name": {
    "first": "John",
    "last": "Doe",
    "middle": "Michael"
  },
  "date_of_birth": "1985-06-15",
  "nationalities": [
    "US"
  ],
  "address": {
    "street1": "123 Main St",
    "city": "San Francisco",
    "country": "US",
    "street2": "Apt 4B",
    "street3": "Building C",
    "region": "California",
    "postal_code": "94105"
  },
  "email_address": "john.doe@acme.com",
  "title": "ceo",
  "employment_status": "employed",
  "ownership_percentage": 25.5,
  "ssn": "123-45-6789",
  "purpose_of_account": [
    "investing",
    "storage_of_funds_or_digital_assets"
  ],
  "source_of_wealth": [
    "employment",
    "savings"
  ]
}
'
{
  "application_id": "1NFHrqBHb3cTfLVkFSGmHZqdDPi",
  "application_status": "pending",
  "individual": {
    "id": "2hCjxJzUAW6JVRkZqaF9E0KpM3b",
    "first_name": "John",
    "last_name": "Doe",
    "date_of_birth": "1985-06-15",
    "nationalities": [
      "US"
    ],
    "address": {
      "street1": "123 Main St",
      "city": "San Francisco",
      "country": "US",
      "street2": "Apt 4B",
      "street3": "Building C",
      "region": "California",
      "postal_code": "94105"
    },
    "email_address": "john.doe@example.com",
    "phone_number": "+1-555-123-4567",
    "employment_status": "employed",
    "purpose_of_account": [
      "investing",
      "storage_of_funds_or_digital_assets"
    ],
    "source_of_wealth": [
      "employment",
      "savings"
    ],
    "decision": "approved",
    "decision_reason": "All verification checks passed",
    "decision_by": "admin@dakota.xyz",
    "decision_at": 1705315800,
    "sumsub_verification": {
      "applicant_id": "2hCjxJzUAW6JVRkZqaF9E0KpM3b",
      "provider_applicant_id": "65a1b2c3d4e5f6g7h8i9j0k1",
      "entity_type": "individual",
      "type": "individual",
      "decision": "approved",
      "decision_reason": "All verification checks passed",
      "decision_by": "admin@dakota.xyz",
      "decision_at": 1705315800,
      "review": {
        "review_id": "65a1b2c3d4e5f6g7h8i9j0k1",
        "attempt_id": "65a1b2c3d4e5f6g7h8i9j0k2",
        "attempt_cnt": 1,
        "level_name": "basic-kyc-level",
        "create_date": "2024-01-15T10:30:00Z",
        "review_date": "2024-01-15T14:45:00Z",
        "review_status": "completed",
        "review_result": {
          "review_answer": "GREEN",
          "reject_labels": [
            "DOCUMENT_TEMPLATE",
            "FRAUDULENT_PATTERNS"
          ],
          "reject_type": "FINAL",
          "button_ids": [
            "approve"
          ],
          "moderation_comment": "All documents verified successfully",
          "client_comment": "Approved for onboarding"
        }
      },
      "risk_labels": {
        "device": [
          "EMULATOR",
          "VPN"
        ],
        "cross_check": [
          "FAKE_ID",
          "BLACKLIST"
        ],
        "attempt_id": "65a1b2c3d4e5f6g7h8i9j0k2",
        "created_at": "2024-01-15T10:30:00Z"
      }
    }
  },
  "application_decision": "approved"
}

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.

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
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 (optional, typically provided for UBO/shareholders, must be > 0 and <= 100 if provided)

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

25.5

​
ssn
string

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

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 application details updated successfully

Response containing individual entity data

​
application_id
string
required

The application ID

Required string length: 27
Example:

"1NFHrqBHb3cTfLVkFSGmHZqdDPi"

​
application_status
enum<string>
required

Current status of the application

Available options:
pending,
submitted,
completed
Example:

"pending"

​
individual
object
required

The individual entity data

​
application_decision
enum<string> | null

Decision outcome (if any)

Available options:
approved,
declined,
withdrawn