Sign in

v1

latestOpenAPI 3.0.1MIT2026-07-261190449.2 KB
Cards

Update Card Validity Period

Update the validity period of a card. This validity period is set during card issuing.

put/cards/{cardId}/validity-period

Path parameters

cardIdstring uuid required

The ID of the card to update.

Request body

validFromstring date required

Field to describe a fixed date range in which the card is usable for purchases. Outside of this date range, the card cannot be used for any purchases, only for zero-amount card-checks, and is shown with status PENDING. Date needs to be provided as yyyy-mm-dd and is treated inclusive, meaning the provided date is already a valid day to use the card. The earliest possible date is the current date. The validFrom date needs to be before the validTo date. The fields validFrom, validTo and validTimezone need to be used together.

validTostring date required

Field to describe a fixed date range in which the card is usable for purchases, replaces the validityPeriod if used. After the specified date, the card is automatically terminated. Date needs to be provided as yyyy-mm-dd and is treated inclusive, meaning the card will be terminated one day after this date. If used, the parallel usage of card controls regarding dates and/or times is not allowed and the validityPeriod will be set to 36 months automatically. The earliest possible date is the current date. The latest possible date is the end date of the validityPeriod. The fields validFrom, validTo and validTimezone need to be used together.

validTimezonestring required

Field to describe the timezone for the validFrom and validTo fields. A list of valid timezones can be found in our guide section.

Example request

{
  "validFrom": "1970-01-30",
  "validTo": "1970-01-30",
  "validTimezone": "Europe/Berlin"
}

Response

Ok. Card validity period was updated successfully.