One card's full lifecycle

GET /api/v1/cards/{id}/timeline prm_cards_list

Header facts plus the chronological event list for a single card: when it was minted, printed, sold, transferred and redeemed.

This endpoint's rate-limit bucket counts DENIED lookups too, on purpose. The limiter sits ahead of the visibility check, so a walk of the card id space burns budget rather than running unmetered behind a 404.

At a glance

Authentication: Staff token or session
Requires permission: prm_cards_list View card batches & cards
Rate limit: card_timeline

Parameters

Parameter	Description
`id`required path · integer	Card id.

Errors

Code	When it is returned
`ERR_NOT_FOUND`404	no such card, or one outside the caller's subtree

Request

curl -X GET "$BASE/api/v1/cards/{id}/timeline" \
  -H "Authorization: Bearer $XR_TOKEN"

BASE is your tenant host: the same address you sign in on.

Try it on your own network.

50 subscribers for 7 days. You pay nothing.

Try it free Talk to us