---
title: "Create a Card details token"
method: POST
path: "/cards/{card_id}/create_details_token"
---

# Create a Card details token

`POST /cards/{card_id}/create_details_token`

Create a short-lived token that authorizes [Card Elements](/documentation/card-elements) to render the details of a Card in your frontend. Mint the token on your server and pass it to the browser; the token is valid for one hour and is scoped to a single Card.

## Path parameters

- `card_id` string, required — The identifier of the Card to mint a details token for.

## Response `200`

Card details token

- CardDetailsToken — A short-lived token that authorizes Increase Card Elements to render the details of a single Card.
  - `expires_at` string, date-time, required — The time the token will expire. Tokens are valid for one hour.
  - `token` string, required — The token. Pass this to the `@increasebank/card-elements` library in your frontend. Treat it as a credential: it authorizes anyone holding it to read the Card's details until it expires.
  - `type` 'card_details_token', required — A constant representing the object's type. For this resource it will always be `card_details_token`.

## Other responses

- `4XX` — Error
- `5XX` — Error

## Changes

- **2026-09-22** `c3efb1c0fcca` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/increase/apis/increase-api-2/changes/cards/:card_id/create_details_token/post.md)

---

[API](https://skmtc.dev/increase/apis/increase-api-2.md) · [All operations](https://skmtc.dev/increase/apis/increase-api-2/llms.txt) · [OpenAPI document](https://skmtc.dev/increase/apis/increase-api-2/revisions/ff98a6043c63?raw)