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, prepaid, points or faced) — read the keys your card type has and ignore the rest, so a new card type cannot break your parser.

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