---
title: "Update credential status"
method: POST
path: "/credentials/status"
tags: ["StatusManagement"]
---

# Update credential status

`POST /credentials/status`

Updates the status of a credential in the status list. This endpoint supports updates by `credentialId` or `statusListIndex`, along with optional parameters for `statusListId` or correlation IDs.

## Query parameters

- `statusListId` string
- `statusListCorrelationId` string
- `entryCorrelationId` string

## Request body

- UpdateStatusRequest
  - `statusListId` string, nullable — ID of the status list.
  - `statusListCorrelationId` string, nullable — A correlation Id for the status list. This is typically a business key
  - `credentialId` string, nullable — An optional credentialId if you kown the value. Can be used for a lookup instead of the statusListIndex or entryCorrelationId
  - `statusListIndex` number, nullable — The index in the statusList. Needs to be provided in case a statusListIndex or entryCorrelationId is not used
  - `entryCorrelationId` string, nullable — An entry correlation Id for the status list. This is typically a business key associated with an index. It allows you to associated business data in your Line of business system with this index, so you can update the status later on more easily
  - `credentialStatus` object[]
    - `status` '0' | '1' — New status value for the entry.

## Response `200`

Credential status updated successfully.

- object
  - `success` boolean
  - `statusesUpdated` integer

## Other responses

- `400` — Invalid input was provided.
- `404` — The resource could not be found
- `500` — An internal server error occurred.

---

[API](https://skmtc.dev/sphereon-opensource/apis/status-list-management-api.md) · [All operations](https://skmtc.dev/sphereon-opensource/apis/status-list-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sphereon-opensource/status-list-management-api/revisions/06ec83a32f5a/schema)