---
title: "Get Token Charges"
method: GET
path: "/api/v1/tokens/{tokenId}/charges"
---

# Get Token Charges

`GET /api/v1/tokens/{tokenId}/charges`

Get the charges on a `pay` or `kya-pay` token as a buyer agent.

## Path parameters

- `tokenId` string, required

## Response `200`

200

- object
  - `data` object[], required
    - `tokenId` string, required — The unique identifier for the payment token associated with this charge. Matches the path parameter `tokenId`.
    - `chargeId` string, required — The unique identifier for an individual charge event.
    - `claimId` string, required — The claim identifier returned by the payment token system, often matching the `tokenId`.
    - `value` string, required — The monetary amount charged.
    - `chargedAt` string, required — The ISO timestamp when the charge was created.
    - `settledAt` string, required — The ISO timestamp when the charge was settled, or null if not settled yet.
    - `network` string, required — The payment network used for the charge.
    - `tokenType` string, required — One of `pay` or `kya-pay`.
    - `audience` string, required — The identifier of the seller agent that this token was created for.
    - `subject` string, required — The identifier of the buyer that this token was created by.
    - `sellerServiceId` string, required — The identifier of the seller service that this token was created for.

## Other responses

- `422` — 422

---

[API](https://skmtc.net/skyfire/apis/skyfire-agent-and-token-apis.md) · [All operations](https://skmtc.net/skyfire/apis/skyfire-agent-and-token-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/skyfire/skyfire-agent-and-token-apis/revisions/209ba8f90d59/schema)