---
title: "aid_customers_tokens_events_get"
method: GET
path: "/accounts/{aid}/customers/tokens/events"
tags: ["tokens"]
---

# aid_customers_tokens_events_get

`GET /accounts/{aid}/customers/tokens/events`

## Request

- Base URL: `https://api.dintero.com/v1`
- URL: `https://api.dintero.com/v1/accounts/{aid}/customers/tokens/events`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/dintero/apis/account-management-api/docs/accounts/:aid/customers/tokens/events/get.ts> (a function with typed inputs; its response is checked against the schema)

Get the token events
scopes:
- admin:customers
- read:customers

## Path parameters

- `aid` string, ^[PT]{1}\d{8}$, required

## Query parameters

- `limit` integer
- `starting_after` string
- `since_datetime` string, date-time
- `deleted_since` string, date-time

## Response `200`

events collection

- object[]
  - `id` string: Auto-generated ID identifying the token type/value.
  - `status` string: The status resolved from latest events registered on given token type and value
  - `events` TokenEvent[]: Events recorded given token type and value
    - `expires_at` string, date-time
    - `created_at` string, date-time
    - `event` string, required: context about the event
    - `status` string: State to set on given token type and value
    - `metadata` object: Additional metadata about the event

## Other responses

- `400`: Bad / Invalid request
- `401`: Access forbidden, invalid JWT token was used
- `403`: Forbidden
- `404`: Resource was not found

---

[API](https://skmtc.dev/dintero/apis/account-management-api.md) - [All operations](https://skmtc.dev/dintero/apis/account-management-api/llms.txt) - [OpenAPI document](https://skmtc.dev/dintero/apis/account-management-api/revisions/9b83a4199008?raw)