Skip to main content
GET
/
policies
List all policies
curl --request GET \
  --url https://api.platform.dakota.xyz/policies \
  --header 'x-api-key: <api-key>'
{
  "data": [
    {
      "id": "pol_2N4YkKpKu7M3mKpGYmF8kcJ8oZT",
      "version": 1,
      "name": "High Value Transaction Policy",
      "created_at": 1640995200,
      "updated_at": 1640995200,
      "client_id": "1NFHrqBHb3cTfLVkFSGmHZqdDPi",
      "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
        }
      ]
    }
  ],
  "meta": {
    "total_count": 100,
    "has_more_after": true,
    "has_more_before": false,
    "limit_reached": false
  }
}

Authorizations

​
x-api-key
string
header
required

Query Parameters

​
starting_after
string

A cursor for use in pagination. starting_after is a KSUID for the object you are listing that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with ID 2B5J8KZ9N7M1K3P6Q8R4T7V9, your subsequent call can include starting_after=2B5J8KZ9N7M1K3P6Q8R4T7V9 in order to fetch the next page of the list. 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"

​
ending_before
string

A cursor for use in pagination. ending_before is a KSUID for the object you are listing that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with ID 2B5J8KZ9N7M1K3P6Q8R4T7V9, your subsequent call can include ending_before=2B5J8KZ9N7M1K3P6Q8R4T7V9 in order to fetch the previous page of the list. 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"

​
limit
integer
default:20

A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 20.

Required range: 1 <= x <= 100

Response

List of policies

Wrapper for paginated list responses

​
data
object[]
required

List of objects returned by the API

​
meta
object
required

Meta information about the response