Cards

An issued card is a specific credential a card holder has held. One holder has many cards over time; revoked and superseded cards remain as history.

The card object

Field	Notes
id	uuid
cardHolderId	uuid of the holder
serialNumber	The number on the card
verificationCode	The code behind the card’s QR code. See Verification
status	pending, issued, active, lost, stolen, damaged, expired or revoked
issuedAt, expiresAt	When issued, and the date the card stops being valid
revokedAt, revocationReason	Set when revoked
createdAt

List issued cards

GET/cardsscope: cards:read

Query parameter	Description
page, pageSize	Pagination. pageSize maximum 200
status	Filter by card status

Newest first.

curl -sS "$CARDOFFICE_API/cards?status=active&pageSize=100" \
  -H "Authorization: Bearer $CARDOFFICE_KEY"

{
  "data": [
    {
      "id": "c2a4f0f6-1f1b-4b0a-9d7c-0d1b6e5e4a21",
      "cardHolderId": "0b5e4c1a-6a53-4d3b-9d45-3f6f6b2c9a10",
      "serialNumber": "AC-000123",
      "verificationCode": "7KQ2-M4XD-9F1B",
      "status": "active",
      "issuedAt": "2027-02-03T01:00:00.000Z",
      "expiresAt": "2027-12-31",
      "revokedAt": null,
      "revocationReason": null,
      "createdAt": "2027-02-03T00:58:12.000Z"
    }
  ],
  "meta": { "page": 1, "pageSize": 100, "total": 1 }
}

To follow changes incrementally, such as revocations, use the cursor form of this endpoint described in Sync feeds.