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>' \
  --header 'x-idempotency-key: <x-idempotency-key>' \
  --data '
{
  "legal_name": "Acme Corporation",
  "country_of_incorporation": "US",
  "date_of_incorporation": "2020-01-15",
  "legal_structure": "llc",
  "tax_id_number": "12-3456789",
  "registration_number": "123456789",
  "dba": "Acme Inc",
  "registered_address": {
    "street1": "123 Main St",
    "street2": "Apt 4B",
    "street3": "Building C",
    "city": "San Francisco",
    "region": "California",
    "postal_code": "94105",
    "country": "US"
  },
  "operating_address": {
    "street1": "123 Main St",
    "street2": "Apt 4B",
    "street3": "Building C",
    "city": "San Francisco",
    "region": "California",
    "postal_code": "94105",
    "country": "US"
  },
  "website": "https://www.acme.com",
  "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,
  "transact_on_behalf_of_third_parties": false,
  "owned_by_foundation": false
}
'

const options = {
  method: 'PUT',
  headers: {
    'x-idempotency-key': '<x-idempotency-key>',
    'X-Application-Token': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    legal_name: 'Acme Corporation',
    country_of_incorporation: 'US',
    date_of_incorporation: '2020-01-15',
    legal_structure: 'llc',
    tax_id_number: '12-3456789',
    registration_number: '123456789',
    dba: 'Acme Inc',
    registered_address: {
      street1: '123 Main St',
      street2: 'Apt 4B',
      street3: 'Building C',
      city: 'San Francisco',
      region: 'California',
      postal_code: '94105',
      country: 'US'
    },
    operating_address: {
      street1: '123 Main St',
      street2: 'Apt 4B',
      street3: 'Building C',
      city: 'San Francisco',
      region: 'California',
      postal_code: '94105',
      country: 'US'
    },
    website: 'https://www.acme.com',
    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,
    transact_on_behalf_of_third_parties: false,
    owned_by_foundation: false
  })
};

fetch('https://api.platform.dakota.xyz/applications/{application_id}/business-details', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.platform.dakota.xyz/applications/{application_id}/business-details"

payload = {
    "legal_name": "Acme Corporation",
    "country_of_incorporation": "US",
    "date_of_incorporation": "2020-01-15",
    "legal_structure": "llc",
    "tax_id_number": "12-3456789",
    "registration_number": "123456789",
    "dba": "Acme Inc",
    "registered_address": {
        "street1": "123 Main St",
        "street2": "Apt 4B",
        "street3": "Building C",
        "city": "San Francisco",
        "region": "California",
        "postal_code": "94105",
        "country": "US"
    },
    "operating_address": {
        "street1": "123 Main St",
        "street2": "Apt 4B",
        "street3": "Building C",
        "city": "San Francisco",
        "region": "California",
        "postal_code": "94105",
        "country": "US"
    },
    "website": "https://www.acme.com",
    "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,
    "transact_on_behalf_of_third_parties": False,
    "owned_by_foundation": False
}
headers = {
    "x-idempotency-key": "<x-idempotency-key>",
    "X-Application-Token": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.platform.dakota.xyz/applications/{application_id}/business-details"

	payload := strings.NewReader("{\n  \"legal_name\": \"Acme Corporation\",\n  \"country_of_incorporation\": \"US\",\n  \"date_of_incorporation\": \"2020-01-15\",\n  \"legal_structure\": \"llc\",\n  \"tax_id_number\": \"12-3456789\",\n  \"registration_number\": \"123456789\",\n  \"dba\": \"Acme Inc\",\n  \"registered_address\": {\n    \"street1\": \"123 Main St\",\n    \"street2\": \"Apt 4B\",\n    \"street3\": \"Building C\",\n    \"city\": \"San Francisco\",\n    \"region\": \"California\",\n    \"postal_code\": \"94105\",\n    \"country\": \"US\"\n  },\n  \"operating_address\": {\n    \"street1\": \"123 Main St\",\n    \"street2\": \"Apt 4B\",\n    \"street3\": \"Building C\",\n    \"city\": \"San Francisco\",\n    \"region\": \"California\",\n    \"postal_code\": \"94105\",\n    \"country\": \"US\"\n  },\n  \"website\": \"https://www.acme.com\",\n  \"industry_code\": \"541511\",\n  \"business_description\": \"Software development and technology consulting services\",\n  \"purpose_of_account\": [\n    \"first_party_payments\",\n    \"business_expenses\"\n  ],\n  \"average_monthly_revenue\": \"1m_to_5m\",\n  \"expected_monthly_deposit\": \"100k_to_500k\",\n  \"expected_monthly_transaction_volume\": \"50_to_100\",\n  \"source_of_funds\": [\n    \"proprietary_funds\",\n    \"customer_funds\"\n  ],\n  \"has_bearer_shares\": false,\n  \"transact_on_behalf_of_third_parties\": false,\n  \"owned_by_foundation\": false\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("x-idempotency-key", "<x-idempotency-key>")
	req.Header.Add("X-Application-Token", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "application_id": "1NFHrqBHb3cTfLVkFSGmHZqdDPi",
  "application_status": "pending",
  "application_decision": "approved",
  "business": {
    "id": "2hCjxJzUAW6JVRkZqaF9E0KpM3a",
    "legal_name": "Acme Corporation",
    "country_of_incorporation": "US",
    "date_of_incorporation": "2020-01-15",
    "legal_structure": "llc",
    "registration_number": "123456789",
    "tax_id_number": "12-3456789",
    "dba": "Acme Inc",
    "registered_address": {
      "street1": "123 Main St",
      "street2": "Apt 4B",
      "street3": "Building C",
      "city": "San Francisco",
      "region": "California",
      "postal_code": "94105",
      "country": "US"
    },
    "operating_address": {
      "street1": "123 Main St",
      "street2": "Apt 4B",
      "street3": "Building C",
      "city": "San Francisco",
      "region": "California",
      "postal_code": "94105",
      "country": "US"
    },
    "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"
    ],
    "has_bearer_shares": false,
    "transact_on_behalf_of_third_parties": false,
    "website": "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"
      }
    }
  }
}

{
  "type": "https://docs.dakota.xyz/api-reference/errors#invalid-request",
  "title": "Invalid request or validation errors",
  "status": 400,
  "detail": "Invalid request or validation errors",
  "instance": "https://api.platform.dakota.xyz/applications/example-id/business-details",
  "request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6"
}

{
  "type": "https://docs.dakota.xyz/api-reference/errors#authentication-error",
  "title": "Unauthorized",
  "status": 401,
  "detail": "Unauthorized",
  "instance": "https://api.platform.dakota.xyz/applications/example-id/business-details",
  "request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6"
}

{
  "type": "https://docs.dakota.xyz/api-reference/errors#forbidden",
  "title": "Application not in pending state or forbidden",
  "status": 403,
  "detail": "Application not in pending state or forbidden",
  "instance": "https://api.platform.dakota.xyz/applications/example-id/business-details",
  "request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6"
}

{
  "type": "https://docs.dakota.xyz/api-reference/errors#not-found",
  "title": "Application or business not found",
  "status": 404,
  "detail": "Application or business not found",
  "instance": "https://api.platform.dakota.xyz/applications/example-id/business-details",
  "request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6"
}

{
  "type": "https://docs.dakota.xyz/api-reference/errors#conflict",
  "title": "Application already submitted or completed (cannot modify)",
  "status": 409,
  "detail": "Application already submitted or completed (cannot modify)",
  "instance": "https://api.platform.dakota.xyz/applications/example-id/business-details",
  "request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6"
}

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>' \
  --header 'x-idempotency-key: <x-idempotency-key>' \
  --data '
{
  "legal_name": "Acme Corporation",
  "country_of_incorporation": "US",
  "date_of_incorporation": "2020-01-15",
  "legal_structure": "llc",
  "tax_id_number": "12-3456789",
  "registration_number": "123456789",
  "dba": "Acme Inc",
  "registered_address": {
    "street1": "123 Main St",
    "street2": "Apt 4B",
    "street3": "Building C",
    "city": "San Francisco",
    "region": "California",
    "postal_code": "94105",
    "country": "US"
  },
  "operating_address": {
    "street1": "123 Main St",
    "street2": "Apt 4B",
    "street3": "Building C",
    "city": "San Francisco",
    "region": "California",
    "postal_code": "94105",
    "country": "US"
  },
  "website": "https://www.acme.com",
  "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,
  "transact_on_behalf_of_third_parties": false,
  "owned_by_foundation": false
}
'

const options = {
  method: 'PUT',
  headers: {
    'x-idempotency-key': '<x-idempotency-key>',
    'X-Application-Token': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    legal_name: 'Acme Corporation',
    country_of_incorporation: 'US',
    date_of_incorporation: '2020-01-15',
    legal_structure: 'llc',
    tax_id_number: '12-3456789',
    registration_number: '123456789',
    dba: 'Acme Inc',
    registered_address: {
      street1: '123 Main St',
      street2: 'Apt 4B',
      street3: 'Building C',
      city: 'San Francisco',
      region: 'California',
      postal_code: '94105',
      country: 'US'
    },
    operating_address: {
      street1: '123 Main St',
      street2: 'Apt 4B',
      street3: 'Building C',
      city: 'San Francisco',
      region: 'California',
      postal_code: '94105',
      country: 'US'
    },
    website: 'https://www.acme.com',
    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,
    transact_on_behalf_of_third_parties: false,
    owned_by_foundation: false
  })
};

fetch('https://api.platform.dakota.xyz/applications/{application_id}/business-details', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.platform.dakota.xyz/applications/{application_id}/business-details"

payload = {
    "legal_name": "Acme Corporation",
    "country_of_incorporation": "US",
    "date_of_incorporation": "2020-01-15",
    "legal_structure": "llc",
    "tax_id_number": "12-3456789",
    "registration_number": "123456789",
    "dba": "Acme Inc",
    "registered_address": {
        "street1": "123 Main St",
        "street2": "Apt 4B",
        "street3": "Building C",
        "city": "San Francisco",
        "region": "California",
        "postal_code": "94105",
        "country": "US"
    },
    "operating_address": {
        "street1": "123 Main St",
        "street2": "Apt 4B",
        "street3": "Building C",
        "city": "San Francisco",
        "region": "California",
        "postal_code": "94105",
        "country": "US"
    },
    "website": "https://www.acme.com",
    "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,
    "transact_on_behalf_of_third_parties": False,
    "owned_by_foundation": False
}
headers = {
    "x-idempotency-key": "<x-idempotency-key>",
    "X-Application-Token": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.platform.dakota.xyz/applications/{application_id}/business-details"

	payload := strings.NewReader("{\n  \"legal_name\": \"Acme Corporation\",\n  \"country_of_incorporation\": \"US\",\n  \"date_of_incorporation\": \"2020-01-15\",\n  \"legal_structure\": \"llc\",\n  \"tax_id_number\": \"12-3456789\",\n  \"registration_number\": \"123456789\",\n  \"dba\": \"Acme Inc\",\n  \"registered_address\": {\n    \"street1\": \"123 Main St\",\n    \"street2\": \"Apt 4B\",\n    \"street3\": \"Building C\",\n    \"city\": \"San Francisco\",\n    \"region\": \"California\",\n    \"postal_code\": \"94105\",\n    \"country\": \"US\"\n  },\n  \"operating_address\": {\n    \"street1\": \"123 Main St\",\n    \"street2\": \"Apt 4B\",\n    \"street3\": \"Building C\",\n    \"city\": \"San Francisco\",\n    \"region\": \"California\",\n    \"postal_code\": \"94105\",\n    \"country\": \"US\"\n  },\n  \"website\": \"https://www.acme.com\",\n  \"industry_code\": \"541511\",\n  \"business_description\": \"Software development and technology consulting services\",\n  \"purpose_of_account\": [\n    \"first_party_payments\",\n    \"business_expenses\"\n  ],\n  \"average_monthly_revenue\": \"1m_to_5m\",\n  \"expected_monthly_deposit\": \"100k_to_500k\",\n  \"expected_monthly_transaction_volume\": \"50_to_100\",\n  \"source_of_funds\": [\n    \"proprietary_funds\",\n    \"customer_funds\"\n  ],\n  \"has_bearer_shares\": false,\n  \"transact_on_behalf_of_third_parties\": false,\n  \"owned_by_foundation\": false\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("x-idempotency-key", "<x-idempotency-key>")
	req.Header.Add("X-Application-Token", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "application_id": "1NFHrqBHb3cTfLVkFSGmHZqdDPi",
  "application_status": "pending",
  "application_decision": "approved",
  "business": {
    "id": "2hCjxJzUAW6JVRkZqaF9E0KpM3a",
    "legal_name": "Acme Corporation",
    "country_of_incorporation": "US",
    "date_of_incorporation": "2020-01-15",
    "legal_structure": "llc",
    "registration_number": "123456789",
    "tax_id_number": "12-3456789",
    "dba": "Acme Inc",
    "registered_address": {
      "street1": "123 Main St",
      "street2": "Apt 4B",
      "street3": "Building C",
      "city": "San Francisco",
      "region": "California",
      "postal_code": "94105",
      "country": "US"
    },
    "operating_address": {
      "street1": "123 Main St",
      "street2": "Apt 4B",
      "street3": "Building C",
      "city": "San Francisco",
      "region": "California",
      "postal_code": "94105",
      "country": "US"
    },
    "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"
    ],
    "has_bearer_shares": false,
    "transact_on_behalf_of_third_parties": false,
    "website": "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"
      }
    }
  }
}

{
  "type": "https://docs.dakota.xyz/api-reference/errors#invalid-request",
  "title": "Invalid request or validation errors",
  "status": 400,
  "detail": "Invalid request or validation errors",
  "instance": "https://api.platform.dakota.xyz/applications/example-id/business-details",
  "request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6"
}

{
  "type": "https://docs.dakota.xyz/api-reference/errors#authentication-error",
  "title": "Unauthorized",
  "status": 401,
  "detail": "Unauthorized",
  "instance": "https://api.platform.dakota.xyz/applications/example-id/business-details",
  "request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6"
}

{
  "type": "https://docs.dakota.xyz/api-reference/errors#forbidden",
  "title": "Application not in pending state or forbidden",
  "status": 403,
  "detail": "Application not in pending state or forbidden",
  "instance": "https://api.platform.dakota.xyz/applications/example-id/business-details",
  "request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6"
}

{
  "type": "https://docs.dakota.xyz/api-reference/errors#not-found",
  "title": "Application or business not found",
  "status": 404,
  "detail": "Application or business not found",
  "instance": "https://api.platform.dakota.xyz/applications/example-id/business-details",
  "request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6"
}

{
  "type": "https://docs.dakota.xyz/api-reference/errors#conflict",
  "title": "Application already submitted or completed (cannot modify)",
  "status": 409,
  "detail": "Application already submitted or completed (cannot modify)",
  "instance": "https://api.platform.dakota.xyz/applications/example-id/business-details",
  "request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6"
}

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

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.

Show child attributes

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,

grants,

intercompany_transfer

Example:

["proprietary_funds", "customer_funds"]

has_bearer_shares

boolean

required

Whether the company issues bearer shares

Example:

false

transact_on_behalf_of_third_parties

boolean

required

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

Example:

false

owned_by_foundation

boolean

required

Whether the business is owned by a foundation

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.

Show child attributes

website

string

Business website URL

Example:

"https://www.acme.com"

business_email

string<email>

Primary business contact email address

Example:

"contact@acmecorp.com"

Response

Business application details updated successfully

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

business

object

required

The business entity data

Show child attributes

application_decision

enum<string> | null

Decision outcome (if any)

Available options:

approved,

declined,

withdrawn

Remove associated individual from business application Get EDD record for application

⌘I

API documentation

Customers

Wallets

Transactions

Recipients

Accounts

Auto Transactions

Onboarding

Policies

Signer Groups

Authentication

Users

Webhooks

Events

Info

Sandbox

Self Serve

Agentic Payments

Mandates

Insights

Payouts

Update business application details

Authorizations

Headers

Path Parameters

Body

Response