List events

curl --request GET \
  --url https://api.platform.dakota.xyz/events \
  --header 'x-api-key: <api-key>'

{
  "data": [
    {
      "id": "1NFHrqBHb3cTfLVkFSGmHZqdDPi",
      "type": "transaction.auto.updated",
      "created": 1735689600,
      "api_version": "1.0.0",
      "data": {
        "object": {
          "id": "1NFHrqBHb3cTfLVkFSGmHZqdDPi",
          "auto_account_id": "1NFHrqBHb3cTfLVkFSGmHZqdDPj",
          "status": "completed"
        }
      },
      "metadata": {
        "source": "platform"
      }
    }
  ],
  "meta": {
    "total_count": 100,
    "has_more_after": true,
    "has_more_before": false
  }
}

Events

List events

Returns a paginated event stream for the authenticated client for audit and operational troubleshooting.

customer.kyb_status.updated events may include a reason_code field in data.object when the status change is driven by the Proof-of-Address (PoA) flow:

pending_proof_of_address — emitted on freeze when the customer’s rolling 7-day inbound volume exceeds the PoA-required threshold and no PoA is on file.
proof_of_address_rejected — emitted when compliance rejects a submitted PoA document.
proof_of_address_approved — emitted when compliance approves a submitted PoA, unfreezing the customer.

Other customer.kyb_status.* events do not include reason_code.

GET

/

events

List events

curl --request GET \
  --url https://api.platform.dakota.xyz/events \
  --header 'x-api-key: <api-key>'

{
  "data": [
    {
      "id": "1NFHrqBHb3cTfLVkFSGmHZqdDPi",
      "type": "transaction.auto.updated",
      "created": 1735689600,
      "api_version": "1.0.0",
      "data": {
        "object": {
          "id": "1NFHrqBHb3cTfLVkFSGmHZqdDPi",
          "auto_account_id": "1NFHrqBHb3cTfLVkFSGmHZqdDPj",
          "status": "completed"
        }
      },
      "metadata": {
        "source": "platform"
      }
    }
  ],
  "meta": {
    "total_count": 100,
    "has_more_after": true,
    "has_more_before": 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

Pattern: ^[0-9A-Za-z]{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

Pattern: ^[0-9A-Za-z]{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

A list of events

Wrapper for paginated list responses

data

object[]

required

List of objects returned by the API

Show child attributes

meta

object

required

Meta information about the response

Show child attributes

Replay a webhook delivery Get countries

⌘I