---
title: "Creates a new status list"
method: POST
path: "/status-lists"
tags: ["Credentials"]
---

# Creates a new status list

`POST /status-lists`

Creates a new status list credential that can be used to track the status of verifiable credentials. The status list is returned as a verifiable credential that can be publicly accessible for verification purposes.

## Request body

- CreateStatusListRequest — Parameters for creating a new status list credential.
  - `statusPurpose` string, required — The purpose of the status list (e.g., "revocation", "suspension"). This determines what type of status information the list will track.
  - `id` string, uri — Optional identifier for the status list. If not provided, the service will generate one.
  - `options` object — Optional parameters for creating the status list, such as size or other configuration options specific to the status list mechanism being used.

## Response `201`

Status list successfully created

- CreateStatusListResponse
  - `verifiableCredential` VerifiableCredential — unresolved $ref
  - `id` string, uri — The identifier of the created status list credential, which can be used to retrieve it via the GET endpoint.

## Other responses

- `400` — Bad Request

## Changes

- **2026-01-28** `9de603962d52` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/w3c/apis/verifiable-credential-api-for-lifecycle-management/changes/status-lists/post.md)

---

[API](https://skmtc.dev/w3c/apis/verifiable-credential-api-for-lifecycle-management.md) · [All operations](https://skmtc.dev/w3c/apis/verifiable-credential-api-for-lifecycle-management/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/w3c/verifiable-credential-api-for-lifecycle-management/revisions/3ba233461759/schema)