Skip to main content
GET
/
policies
/
{policy_id}
Get a specific policy
curl --request GET \
  --url https://api.platform.dakota.xyz/policies/{policy_id} \
  --header 'x-api-key: <api-key>'
{
  "id": "pol_2N4YkKpKu7M3mKpGYmF8kcJ8oZT",
  "client_id": "1NFHrqBHb3cTfLVkFSGmHZqdDPi",
  "version": 1,
  "name": "High Value Transaction Policy",
  "description": "Requires approval for transactions above $10,000",
  "rules": [
    {
      "id": "rule_2N4YkKpKu7M3mKpGYmF8kcJ8oZT",
      "policy_id": "pol_2N4YkKpKu7M3mKpGYmF8kcJ8oZT",
      "rule_type": "amount_threshold",
      "action": "deny",
      "definition": {
        "amount": "10000",
        "currency": "USD"
      },
      "created_at": 1640995200
    }
  ],
  "created_at": 1640995200,
  "updated_at": 1640995200
}

Authorizations

ā€‹
x-api-key
string
header
required

Path Parameters

ā€‹
policy_id
string
required

Unique identifier of the policy

Response

Policy details

ā€‹
id
string
required

Unique identifier for the policy

Example:

"pol_2N4YkKpKu7M3mKpGYmF8kcJ8oZT"

ā€‹
version
integer<int32>
required

Version number of the policy (incremented on rule changes)

Example:

1

ā€‹
name
string
required

Human-readable name for the policy

Example:

"High Value Transaction Policy"

ā€‹
created_at
integer
required

Unix timestamp when the policy was created

Example:

1640995200

ā€‹
updated_at
integer
required

Unix timestamp when the policy was last updated

Example:

1640995200

ā€‹
client_id
string

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"

ā€‹
description
string | null

Optional description of the policy's purpose

Example:

"Requires approval for transactions above $10,000"

ā€‹
rules
object[]

Rules that make up this policy