Cards Bulk Add With Dates Ep

POST 
/v1/cards/bulk_add_with_dates

Add/Update Driver Terminal Card Certification Dates

Bulk sets the certification date on a driver's terminal cards. Each request item is matched to a card on the driver by card_id. When a matching card exists, only its certification date is updated; when no matching card exists, the card is added to the driver with the supplied date (the terminal it belongs to is resolved from the card_id). The rest of the driver record is left untouched.

Required Scopes (idi.w)

Request

A JSON array of objects, one per card to add or update.

driver_id: str
Identifier of the driver whose card is being set.

---

card_id: str
Identifier of the terminal card. A card id belongs to exactly one terminal, so it alone identifies the card on the driver.

---

certification_date: datetime | None = None
The date the driver was certified for the card. Pass null to clear an existing certification date.

Response

success: int
Count of card requests that were applied (added or updated).

---

errors: list[dict]
One entry per request that could not be applied, each with driver_id, card_id, and an error description (e.g. "Driver not found" when the driver does not exist, or "Card not found" when card_id does not match a card on any terminal).

Responses

200

Successful Response

422

Validation Error

application/json

Example (from schema)

{
  "detail": [
    {
      "loc": [
        "string",
        0
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Loading...