Skip to main content
PUT
/
applications
/
{application_id}
/
business-details
Update business application details
curl --request PUT \
  --url https://api.platform.dakota.xyz/applications/{application_id}/business-details \
  --header 'Content-Type: application/json' \
  --header 'X-Application-Token: <api-key>' \
  --data '
{
  "legal_name": "Acme Corporation",
  "country_of_incorporation": "US",
  "date_of_incorporation": "2020-01-15",
  "legal_structure": "llc",
  "registration_number": "123456789",
  "registered_address": {
    "street1": "123 Main St",
    "city": "San Francisco",
    "country": "US",
    "street2": "Apt 4B",
    "street3": "Building C",
    "region": "California",
    "postal_code": "94105"
  },
  "industry_code": "541511",
  "business_description": "Software development and technology consulting services",
  "purpose_of_account": [
    "first_party_payments",
    "business_expenses"
  ],
  "average_monthly_revenue": "1m_to_5m",
  "expected_monthly_deposit": "100k_to_500k",
  "expected_monthly_transaction_volume": "50_to_100",
  "source_of_funds": [
    "proprietary_funds",
    "customer_funds"
  ],
  "has_bearer_shares": false,
  "tax_id_number": "12-3456789",
  "dba": "Acme Inc",
  "operating_address": {
    "street1": "123 Main St",
    "city": "San Francisco",
    "country": "US",
    "street2": "Apt 4B",
    "street3": "Building C",
    "region": "California",
    "postal_code": "94105"
  },
  "website": "https://www.acme.com",
  "transact_on_behalf_of_third_parties": false
}
'
{
  "application_id": "1NFHrqBHb3cTfLVkFSGmHZqdDPi",
  "application_status": "pending",
  "business": {
    "id": "2hCjxJzUAW6JVRkZqaF9E0KpM3a",
    "legal_name": "Acme Corporation",
    "country_of_incorporation": "US",
    "date_of_incorporation": "2020-01-15",
    "legal_structure": "llc",
    "registration_number": "123456789",
    "registered_address": {
      "street1": "123 Main St",
      "city": "San Francisco",
      "country": "US",
      "street2": "Apt 4B",
      "street3": "Building C",
      "region": "California",
      "postal_code": "94105"
    },
    "industry_code": "541511",
    "business_description": "Software development and technology consulting services",
    "purpose_of_account": [
      "first_party_payments",
      "business_expenses"
    ],
    "average_monthly_revenue": "1_to_10m",
    "expected_monthly_deposit": "100k_to_500k",
    "expected_monthly_transaction_volume": "0_to_10",
    "source_of_funds": [
      "proprietary_funds",
      "customer_funds"
    ],
    "tax_id_number": "12-3456789",
    "dba": "Acme Inc",
    "operating_address": {
      "street1": "123 Main St",
      "city": "San Francisco",
      "country": "US",
      "street2": "Apt 4B",
      "street3": "Building C",
      "region": "California",
      "postal_code": "94105"
    },
    "has_bearer_shares": false,
    "transact_on_behalf_of_third_parties": false,
    "website_url": "https://www.acme.com",
    "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
​
legal_name
string
required

Legal name of the business entity

Example:

"Acme Corporation"

​
country_of_incorporation
string
required

ISO 3166-1 alpha-2 country code where the business is incorporated

Required string length: 2
Example:

"US"

​
date_of_incorporation
string<date>
required

Date when the business was incorporated (ISO 8601 format)

Example:

"2020-01-15"

​
legal_structure
enum<string>
required

Legal entity type of the business. Note: trust, government_entity, and sole_proprietorship are not eligible for onboarding.

Available options:
corporation,
llc,
general_partnership,
llp,
non_profit_foundation,
trust,
government_entity,
sole_proprietorship
Example:

"llc"

​
registration_number
string
required

Business registration number

Example:

"123456789"

​
registered_address
Address · object
required

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

​
industry_code
string
required

Industry classification code (NAICS or crypto)

Example:

"541511"

​
business_description
string
required

Detailed description of the business activities

Example:

"Software development and technology consulting services"

​
purpose_of_account
enum<string>[]
required

Intended purposes for the account (at least one required)

Minimum array length: 1
Available options:
operating_otc_service,
accepting_donations,
payment_processing_platform,
third_party_payments,
first_party_payments,
proprietary_trading,
business_expenses,
storage_of_funds_or_assets
Example:
["first_party_payments", "business_expenses"]
​
average_monthly_revenue
enum<string>
required

Expected average monthly revenue range

Available options:
0_to_500k,
500k_to_1m,
1m_to_5m,
5m_to_10m,
10m_to_50m,
50m_to_100m,
100m_plus
Example:

"1m_to_5m"

​
expected_monthly_deposit
enum<string>
required

Expected monthly deposit range

Available options:
0_to_50k,
50k_to_100k,
100k_to_500k,
500k_to_1m,
1m_to_5m,
5m_to_10m,
10m_to_20m,
20m_to_50m,
50m_plus
Example:

"100k_to_500k"

​
expected_monthly_transaction_volume
enum<string>
required

Expected monthly transaction volume range

Available options:
0_to_10,
10_to_20,
20_to_50,
50_to_100,
100_to_250,
250_to_500,
500_plus
Example:

"50_to_100"

​
source_of_funds
enum<string>[]
required

Sources of funds for the business (at least one required)

Minimum array length: 1
Available options:
ico_token_sale,
donations,
loan_funding,
crowdfunding,
proprietary_funds,
sale_of_goods_and_services,
investments,
sale_of_assets,
customer_funds,
intercompany_transfer
Example:
["proprietary_funds", "customer_funds"]
​
has_bearer_shares
boolean
required

Whether the company issues bearer shares

Example:

false

​
tax_id_number
string

Tax identification number (required for US entities)

Example:

"12-3456789"

​
dba
string

Doing Business As name

Example:

"Acme Inc"

​
operating_address
Address · object

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

​
website
string

Business website URL

Example:

"https://www.acme.com"

​
transact_on_behalf_of_third_parties
boolean

Whether the business will transact (trading or transmitting funds) on behalf of third parties. Triggers EDD requirement if true.

Example:

false

Response

Business application details updated successfully

Response containing business 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"

​
business
object
required

The business entity data

​
application_decision
enum<string> | null

Decision outcome (if any)

Available options:
approved,
declined,
withdrawn