Skip to main content
POST
/
applications
/
{application_id}
/
decisions
/
entities
/
{entity_type}
/
{entity_id}
Make a decision on a specific entity (business or individual)
curl --request POST \
  --url https://api.platform.dakota.xyz/applications/{application_id}/decisions/entities/{entity_type}/{entity_id} \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "decision": "approved",
  "decision_reason": "All verification checks passed"
}
'
{
  "success": true,
  "message": "Business entity decision updated to approved"
}

Authorizations

​
x-api-key
string
header
required

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"

​
entity_type
enum<string>
required

Type of entity (business or individual)

Available options:
business,
individual
​
entity_id
string
required

The unique identifier for the entity

Body

application/json

Request to make a decision on an entity or application

​
decision
enum<string>
required

The decision to apply

Available options:
approved,
declined,
auto_declined,
withdrawn
Example:

"approved"

​
decision_reason
string
required

Reason for the decision

Example:

"All verification checks passed"

Response

Entity decision updated successfully

Response after making a decision

​
success
boolean
required

Whether the decision was applied successfully

Example:

true

​
message
string

Description of the operation result

Example:

"Business entity decision updated to approved"