List Cards

Retrieve a paginated list of cards for a project.

GET /projects/{projectId}/cards

Path Parameters

Parameter	Type	Required	Description
projectId	UUID	Yes	Project ID

Query Parameters

Parameter	Type	Default	Description
page	number	1	Page number
limit	number	50	Items per page (max 100)
filter[status]	string	—	Filter by status: new, active, inactive
filter[environment]	string	—	Filter by environment: sandbox, production
search	string	—	Search by card number, license plate, driver
sort[field]	string	—	Sort by field: createdAt, cardNumber, etc.

Request

curl -X GET "https://api.maes-platform.nuvoni.eu/v1/projects/{projectId}/cards?status=active&limit=10" \
  -H "Authorization: Bearer sk_sandbox_xxxxx"

Response

{
  "docs": [
    {
      "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",
      "lastSyncedAt": "2025-12-27T16:24:05.712Z",
      "createdAt": "2025-12-26T10:30:00.000Z",
      "updatedAt": "2025-12-27T16:24:05.712Z"
    }
  ],
  "total": 1
}

Response Fields

Field	Type	Description
docs	array	Array of card objects
total	number	Total number of matching cards

Card Object

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
lastSyncedAt	datetime	Last sync timestamp
createdAt	datetime	Creation timestamp
updatedAt	datetime	Last update timestamp

Examples

Filter by Status

GET /projects/{id}/cards?filter[status]=active

Paginate Results

GET /projects/{id}/cards?page=2&limit=20

Search Cards

GET /projects/{id}/cards?search=AB-123