Get Card token history for specific card and token

Retrieves a paginated list of historical records for a specific token belonging to a card identified by its internal CMS card ID ({id}) and token ID ({tokenid}). Each history entry contains the state of the token at a point in time (e.g., status changes, device updates). The endpoint supports optional paging (size, page) and sorting (sort) parameters.

URL test:

https://test.lightcms.io/cms/v1/cards/{id}/tokens/{tokenid}/history?size={integer}&page={integer}&sort={string}

Method:

GET

Path items:

/cards (Card Service)

/{Id} (CMS card internal unique id)

/tokens (Tokens Service)

/{TokenId} (Specific token identifier)

/history (History sub‑resource)

?size={size}

&page={page}

&sort={sort}

Parameters:

Parameter	Location	Type	Example	Description	Required
id	path	integer	"1"	CMS card internal unique id	Yes
tokenid	path	integer	"44"	Identifier of the token whose history is requested	Yes
size	query	integer	"20"	Number of records per page (default 20)	No
page	query	integer	"0"	Page index, starting at 0	No
sort	query	string	"createdAt,desc"	Sorting criteria in the form property,(asc | desc). Multiple criteria can be comma‑separated.	No

Example:

curl -X 'GET' \
  'https://test.lightcms.io/cms/v1/cards/1/tokens/44/history?size=20&page=0&sort=createdAt,desc' \
  -H 'accept: */*'

Responses:

200 - OK

Status Code: 200 OK

[
{
    "id": 4,
    "tokenId": "44",
    "deviceId": "XX",
    "deviceTypeDescription": "Mobile phone or tablet",
    "deviceType": "04",
    "status": "ACTIVE",
    "tokenRequestorDescription": "GOOGLE_PAY",
    "tokenRequestor": "40010075001",
    "tokenUniqueReferenceId": "DNITHE302516350635179541",
    "panSource": "Card added via application",
    "createdAt": "2025-07-23T09:49:22.322Z",
    "updatedAt": "2025-07-23T09:49:22.322Z"
}
]

Parameter	Type	Example	Description
id	integer	4	Internal history record identifier
tokenId	string	"44"	Token reference used by the card processor
deviceId	string	"XX"	Identifier of the device that enrolled the token
deviceTypeDescription	string	"Mobile phone or tablet"	Human‑readable description of the device type
deviceType	string	"04"	Machine‑readable device type code
status	string	"ACTIVE"	Token status at this point in time (e.g., ACTIVE, REVOKED)
tokenRequestorDescription	string	"GOOGLE_PAY"	Description of who requested the token
tokenRequestor	string	"40010075001"	Code of the requestor
tokenUniqueReferenceId	string	"DNITHE302516350635179541"	Unique reference for the token creation request
panSource	string	"Card added via application"	Source of the PAN used for the token (e.g., CARD, ACCOUNT)
createdAt	string	"2025-07-23T09:49:22.322Z"	Timestamp when this history entry was created (ISO‑8601)
updatedAt	string	"2025-07-23T09:49:22.322Z"	Timestamp of the last update to this history entry (ISO‑8601)

404 - Not Found

Status Code: 404 Not Found

{
    "errorMessage": "Entity with id 100-1863 not found in DB."
}

Parameter	Type	Example	Description
errorMessage	string	"Entity with id 100-1863 not found in DB."	Human‑readable error description

500 - Internal error

Status Code: 500 Internal error

{
    "timestamp": "2025-07-22T13:09:02.348+02:00",
    "status": 500,
    "error": "Internal Server Error",
    "path": "/cms/v1/cards "
}

Parameter	Type	Example	Description
timestamp	string	"2025-07-22T13:09:02.348+02:00"	Time of the error
status	integer	500	HTTP status code
error	string	"Internal Server Error"	Short error title
path	string	"/cms/v1/cards "	Endpoint that produced the error