Get Card tokens

Retrieves a paginated list of token objects that belong to a specific card identified by its internal CMS card ID ({id}). Tokens represent virtual card credentials (e.g., for online payments or mobile wallets) and include details such as the token identifier, device information, status, requestor metadata, and the PAN source. The endpoint supports optional paging (size, page) and sorting (sort) parameters.

URL test:

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

Method:

GET

Path items:

/cards (Card Service)

/{Id} (ID code of specified card)

/tokens (Tokens Service)

Parameters:

Parameter	Location	Type	Example	Description	Required
id	path	integer	"1"	CMS card internal unique id	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.

Example:

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

Responses:

200 - OK

Status Code: 200 OK

    {
        "id": 41,
        "tokenId": "3687122200",
        "deviceId": "JHGCSPbJ6SPk1g1ObozfOAS688",
        "deviceTypeDescription": "Mobile phone or tablet",
        "deviceType": "04",
        "status": "ACTIVE",
        "tokenRequestorDescription": "GOOGLE_PAY",
        "tokenRequestor": "40010075001",
        "tokenUniqueReferenceId": "DNITHE302516350635179541",
        "panSource": "Card added via application"
    },

Parameter	Type	Example	Description
id	integer	4	Internal token identifier
tokenId	string	"44"	Token reference used by the card processor
deviceId	string	"XX"	Identifier of the device that enrolled the token
deviceTypeDescription	string	"44"	Human‑readable description of the device type
deviceType	string	"44"	Machine‑readable device type code
status	string	"44"	Current token status (e.g., ACTIVE, REVOKED)
tokenRequestorDescription	string	"44"	Description of who requested the token
tokenRequestor	string	"44"	Code of the requestor
tokenUniqueReferenceId	string	"44"	Unique reference for the token creation request
panSource	string	"44"	Source of the PAN used for the token (e.g., CARD, ACCOUNT)

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