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

# Create a new status list

`POST /status-lists`

Creates a new status list and returns its status list credential.

## Request body

- CreateStatusListRequest
  - `statusList` CreateStatusList, required
    - `type` 'StatusList2021' | 'OAuthStatusList' — The type of status list to create.
    - `id` string — A unique identifier for the status list (e.g., DID or other unique ID).
    - `issuer` union
      - string — A string identifier of the issuer (such as a DID).
      - Issuer
        - `id` string — A DID or unique identifier for the issuer.
        - `name` string, nullable — The issuer's name (optional).
    - `correlationId` string, nullable — Optional correlation ID for tracking purposes.
    - `length` integer, nullable — Optional length (number of entries) for the status list.
    - `proofFormat` 'jwt' | 'ldp', nullable — Cryptographic proof format (JWT or Linked Data Proof).
    - `keyRef` string, nullable — An optional reference to the key that will sign the status list.
    - `statusList2021` StatusList2021
      - `purpose` 'revocation suspension', nullable — The intended purpose for the status list.
    - `oauthStatusList` OAuthStatusList
      - `bitsPerStatus` number, nullable — The bits per status. Defaults to 1. Allowed values 1,2,4,8

## Response `200`

Status list created successfully.

- string

## Other responses

- `400` — Invalid input was provided.
- `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)