Skip to main content
PUT
/
applications
/
{application_id}
/
edd
Create or update EDD record
curl --request PUT \
  --url https://api.platform.dakota.xyz/applications/{application_id}/edd \
  --header 'Content-Type: application/json' \
  --header 'X-Application-Token: <api-key>' \
  --header 'x-idempotency-key: <x-idempotency-key>' \
  --data '
{
  "account_usage_description": "Processing payments for e-commerce transactions",
  "top_customer_countries": [
    "US",
    "GB",
    "CA"
  ],
  "screens_customers_for_sanctions": true,
  "allow_third_party_access": false,
  "is_token_issuer": false,
  "will_conduct_token_sale": false,
  "token_sale_amount_usd": 1000000,
  "token_sale_availability": "Public sale to accredited investors",
  "token_sale_registration_status": "Registered with SEC",
  "is_regulated": true,
  "unregulated_justification": "Operating in exempt category under local regulations",
  "country_of_regulation": "US",
  "regulatory_license_type": "Money Services Business (MSB)",
  "verifies_customer_identity": true,
  "kyc_service_provider": "Sumsub",
  "has_transaction_monitoring": true,
  "subject_to_aml_audits": true,
  "last_audit_date": "2024-06-30"
}
'
{
  "application_id": "1NFHrqBHb3cTfLVkFSGmHZqdDPi",
  "application_status": "pending",
  "application_decision": "approved",
  "edd": {
    "account_usage_description": "Processing payments for e-commerce transactions",
    "id": "1NFHrqBHb3cTfLVkFSGmHZqdDPi",
    "business_id": "1NFHrqBHb3cTfLVkFSGmHZqdDPi",
    "created_at": "2025-01-15T10:30:00Z",
    "updated_at": "2025-01-15T14:45:00Z",
    "top_customer_countries": [
      "US",
      "GB",
      "CA"
    ],
    "screens_customers_for_sanctions": true,
    "allow_third_party_access": false,
    "is_token_issuer": false,
    "will_conduct_token_sale": false,
    "token_sale_amount_usd": 1000000,
    "token_sale_availability": "Public sale to accredited investors",
    "token_sale_registration_status": "Registered with SEC",
    "is_regulated": true,
    "unregulated_justification": "Operating in exempt category under local regulations",
    "country_of_regulation": "US",
    "regulatory_license_type": "Money Services Business (MSB)",
    "verifies_customer_identity": true,
    "kyc_service_provider": "Sumsub",
    "has_transaction_monitoring": true,
    "subject_to_aml_audits": true,
    "last_audit_date": "2024-06-30",
    "document_info": {
      "uploaded_documents": [
        {
          "document_id": "2hCjxJzUAW6JVRkZqaF9E0KpM3a",
          "document_type": "passport",
          "status": "uploaded",
          "uploaded_at": "2025-01-15T10:30:00Z"
        }
      ],
      "missing_documents": [
        {
          "purpose": "business_formation",
          "accepted_types": [
            "articles_of_incorporation"
          ],
          "description": "Articles of Incorporation or equivalent formation document"
        }
      ]
    }
  }
}

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

The unique identifier for the application 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

Request to create or update an Enhanced Due Diligence (EDD) record

ā€‹
account_usage_description
string
required

Required description of how the account will be used

Example:

"Processing payments for e-commerce transactions"

ā€‹
top_customer_countries
string[]

List of countries where the majority of customers are located

ISO 3166-1 alpha-2 country code

Required string length: 2
Example:
["US", "GB", "CA"]
ā€‹
screens_customers_for_sanctions
boolean

Whether the business screens customers against sanctions lists

Example:

true

ā€‹
allow_third_party_access
boolean

Whether third parties will have access to the account. Auto-declines if true.

Example:

false

ā€‹
is_token_issuer
boolean

Whether the business issues tokens

Example:

false

ā€‹
will_conduct_token_sale
boolean

Whether the business will conduct a token sale

Example:

false

ā€‹
token_sale_amount_usd
number<double>

Amount to be raised in token sale (USD)

Example:

1000000

ā€‹
token_sale_availability
string

Description of token sale availability

Example:

"Public sale to accredited investors"

ā€‹
token_sale_registration_status
string

Registration status with relevant authorities

Example:

"Registered with SEC"

ā€‹
is_regulated
boolean

Whether the business is regulated by financial authorities

Example:

true

ā€‹
unregulated_justification
string

Justification for why the business is not regulated (required if is_regulated=false)

Example:

"Operating in exempt category under local regulations"

ā€‹
country_of_regulation
string

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

Required string length: 2
Example:

"US"

ā€‹
regulatory_license_type
string

Type of regulatory license held (required if is_regulated=true)

Example:

"Money Services Business (MSB)"

ā€‹
verifies_customer_identity
boolean

Whether the business verifies customer identity (KYC)

Example:

true

ā€‹
kyc_service_provider
string

Name of KYC service provider used

Example:

"Sumsub"

ā€‹
has_transaction_monitoring
boolean

Whether the business has transaction monitoring in place

Example:

true

ā€‹
subject_to_aml_audits
boolean

Whether the business is subject to AML audits

Example:

true

ā€‹
last_audit_date
string<date> | null

Date of the last AML audit in YYYY-MM-DD format

Example:

"2024-06-30"

Response

EDD record created or updated successfully

Response containing EDD data with application context

ā€‹
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"

ā€‹
application_decision
enum<string> | null
required

Decision outcome (if any)

Available options:
approved,
declined,
withdrawn
ā€‹
edd
object
required

The EDD data