One card's statistics

GET

/cards/{id}/stats

Per-card activity for a support screen: "how many stamps has this person actually earned, and when did they last come in". kpis is a map whose keys depend on the card type (stamp, gift card (type prepaid), points or faced) — read the keys your card type has and ignore the rest, so a new card type cannot break your parser. Requires an UNRESTRICTED key: a key limited to specific locations is refused with 403 location_scope_unsupported, and shop-wide data is never silently served to it instead. A card is not attributed to a location anywhere in TesserApp — it belongs to a program, and programs belong to the whole shop — so there is no correct subset of cards to serve such a key.

Authorizations

ApiKeyBearer

A shop-scoped API key created in the dashboard and shown exactly once. An MCP tmk_ key presented here returns a 401 that names the mistake.

Type

HTTP (bearer)

Parameters

Path Parameters

id*

An opaque id. The API never promises an id format.

Type

string

Required

Responses

One card's statistics

Content-Type

application/json

{

  

"card_type": "standard",

  

"kpis": {

  

  

"stamps_count": 4

  

},

  

"activity_by_day": [

  

  

{

  

  

  

"date": "2026-09-04",

  

  

  

"value": 12

  

  

}

  

],

  

"timezone": "Europe/Rome"

}

GET

/cards/{id}/stats

Samples

Powered by VitePress OpenAPI