Activate Card

Activate a new card with license plate and driver information.

POST /projects/{projectId}/cards/{cardId}/activate

Path Parameters

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

Request Body

Field	Type	Required	Description
licensePlate	string	Yes	Vehicle license plate
driver	string	Yes	Driver name

Request

curl -X POST "https://api.maes-platform.nuvoni.eu/v1/projects/{projectId}/cards/{cardId}/activate" \
  -H "Authorization: Bearer sk_live_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "licensePlate": "AB-123-CD",
    "driver": "John Doe"
  }'

Response

{
  "id": "09c9861c-4c4b-411f-be85-c16ed7e26da4",
  "cardNumber": "782521009000153700",
  "status": "active",
  "licensePlate": "AB-123-CD",
  "driver": "John Doe",
  "authGasoline": true,
  "authDiesel": true,
  "authLpg": true,
  "authHeatingOil": true
}

Notes

• Only cards with status: new can be activated
• In production, this triggers a background job to update the MAES portal
• All fuel authorizations are enabled by default after activation

Errors

Card Already Active

Status: 400 Bad Request

{
  "code": "error.card_already_active",
  "message": "Card is already activated"
}

Validation Error

Status: 400 Bad Request

{
  "code": "error.validation",
  "message": "Validation failed",
  "details": [
    { "field": "licensePlate", "message": "License plate is required" },
    { "field": "driver", "message": "Driver name is required" }
  ]
}

Card Not Found

Status: 404 Not Found

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