Get Card

Retrieve detailed information about a specific card.

GET /projects/{projectId}/cards/{cardId}

Path Parameters

Parameter	Type	Required	Description
projectId	UUID	Yes	Project ID
cardId	UUID	Yes	Card ID

Request

curl -X GET "https://api.maes-platform.nuvoni.eu/v1/projects/{projectId}/cards/{cardId}" \
  -H "Authorization: Bearer sk_sandbox_xxxxx"

Response

{
  "id": "09c9861c-4c4b-411f-be85-c16ed7e26da4",
  "cardNumber": "782521009000153700",
  "maesCardId": "134208",
  "environment": "production",
  "status": "active",
  "licensePlate": "AB-123-CD",
  "driver": "John Doe",
  "expirationDate": "2027-12-31T00:00:00.000Z",
  "authGasoline": true,
  "authDiesel": true,
  "authLpg": true,
  "authHeatingOil": true,
  "syncStatus": "synced",
  "syncErrorMessage": null,
  "lastSyncedAt": "2025-12-27T16:24:05.712Z",
  "notes": null,
  "internalReference": null,
  "createdAt": "2025-12-26T10:30:00.000Z",
  "updatedAt": "2025-12-27T16:24:05.712Z"
}

Response Fields

Field	Type	Description
id	string (UUID)	Unique card identifier
cardNumber	string	Physical card number
maesCardId	string	MAES internal ID
environment	enum	sandbox or production
status	enum	new, active, inactive
licensePlate	string	Vehicle license plate
driver	string	Driver name
expirationDate	datetime	Card expiration date
authGasoline	boolean	Gasoline authorization
authDiesel	boolean	Diesel authorization
authLpg	boolean	LPG authorization
authHeatingOil	boolean	Heating oil authorization
syncStatus	enum	synced, pending, failed
syncErrorMessage	string	Last sync error (if failed)
lastSyncedAt	datetime	Last sync timestamp
notes	string	Internal notes
internalReference	string	Internal reference ID
createdAt	datetime	Creation timestamp
updatedAt	datetime	Last update timestamp

Errors

Card Not Found

Status: 404 Not Found

{
  "code": "error.card_not_found",
  "message": "Card not found"
}