---
title: "Update Card Status"
method: PUT
path: "/api/v1/cards/{publicToken}/status"
tags: ["Cards"]
---

# Update Card Status

`PUT /api/v1/cards/{publicToken}/status`

## Path parameters

- `publicToken` string, required

## Request body

- SetStatusRequest — Request object for the card status update request.
  - `cardStatusCode` '00' | '04' | '05' | '41' | '43' | '46' | '54' | '57' | '59' | '62' | '63' | '70' | '83' | '98' | '99' | 'G1' | 'G2' | 'G3' | 'G4' | 'G5' | 'G6' | 'G7' | 'G8' | 'G9', nullable — The new status of the card (two character alphanumeric card status code).
  - `status` string, nullable — The new status of the card (string description).
  - `updatedBy` string, nullable — The user updating the card status.
  - `description` string, nullable — The reason for the card status update.
  - `validityDate` string, date-time, nullable — The date when the status will be valid. Format YYYY-MM.

## Response `200`

Success

- SetStatusResponse — API response object for status requests describing the card status.
  - `status` string, nullable — The status of the card (string description).
  - `cardStatusCode` '00' | '04' | '05' | '41' | '43' | '46' | '54' | '57' | '59' | '62' | '63' | '70' | '83' | '98' | '99' | 'G1' | 'G2' | 'G3' | 'G4' | 'G5' | 'G6' | 'G7' | 'G8' | 'G9', nullable — The status code of the card (two character alphanumeric card status code).
  - `updated` string, nullable — Date of last update. Format DD-MM-YYYY.
  - `updatedBy` string, nullable — Optional field describing the user or service which made the last update.
  - `description` string, nullable — Optional field describing the reason for the update.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `422` — Client Error
- `500` — Server Error

---

[API](https://skmtc.dev/thredd/apis/core-cards.md) · [All operations](https://skmtc.dev/thredd/apis/core-cards/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/thredd/core-cards/revisions/841f62def5bf/schema)