---
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`

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.net/dintero/apis/account-management-api.md) · [All operations](https://skmtc.net/dintero/apis/account-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dintero/account-management-api/revisions/9b83a4199008/schema)