---
title: "Introspect Token"
method: POST
path: "/api/v1/tokens/introspect"
---

# Introspect Token

`POST /api/v1/tokens/introspect`

As a seller agent verify that a token is valid and get the remaining balance.

## Request body

- object
  - `token` string, required — The complete JWT string as issued to the buyer, not a tokenId. Can be of any token type: `kya`, `pay`, or `kya-pay`.

## Response `200`

200

- union
  - object
    - `expiresAt` number, required — When the token expires (Unix ms).
    - `isValid` boolean, required — Whether the token was successfully introspected as a known, usable Skyfire token.
    - `validationError` string — Why introspection failed; only when isValid is false.
  - object
    - `chargeableUntil` number, required — Until when charges are allowed (Unix ms).
    - `expiresAt` number, required — When the token expires (Unix ms).
    - `isValid` boolean, required — Whether the token was successfully introspected as a known, usable Skyfire token.
    - `remainingBalance` string, required — Funds left on the token as a decimal string.
    - `validationError` string — Why introspection failed; only when isValid is false.

---

[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)