Cards

Update Card Validity Period

Changed on Nov 3, 2026

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

put/cards/{cardId}/validity-period

Request

Base URL
https://partner-api.getpliant.com/api
Auth
HTTP bearer
TypeScript
https://skmtc.dev/getpliant/apis/pliant-customer-api/docs/cards/:cardId/validity-period/put.ts
A function with typed inputs. Its response is checked against the schema.

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.

Changes

Nov 3, 2026a4fbf7d068b4 Revision changes
- breaking
  the response's body type changed from no type to object for status
- breaking
  the response's body type changed from no type to object for status
- breaking
  the response's body type changed from no type to object for status
- breaking
  the response's body type changed from no type to object for status
- info
  added the media type application/json for the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status

Operation history