---
title: "Create and initialize a new status list."
method: POST
path: "/management/api/status-list"
tags: ["Status List API"]
---

# Create and initialize a new status list.

`POST /management/api/status-list`

## Request

- Base URL: `http://localhost:8080`
- URL: `http://localhost:8080/management/api/status-list`
- Auth: none declared

Initialize and link a status list slot to to this service. This process can be only done once per status list! Status List type, configuration or length can not be changed after initialization!

## Request body

- StatusListCreate
  - `type` string: [DEPRECATED] This parameter is deprecated and should not be sent in future requests.
  - `maxLength` integer, required: How many status entries can be part of the status list. The memory size of the status list is depending on the type and the config of the status list.
  - `config` StatusListCreateConfig, required
    - `purpose` string
    - `bits` integer, required: The number of bits used per Referenced Token. More bits allow additional states. 1 bit is only revocation, 2 bits is revocation and suspension of a credential. Possible values are 1, 2, 4, 8.
  - `configuration_override` ConfigurationOverride: Override for configuration to be use for the created entity
    - `issuer_did` string, nullable: Override to be used in place of the ISSUER_ID
    - `verification_method` string, nullable: Override for the verification method that is looked up in the did document during verification of the entity. Most often the full did and a unique id after #
    - `key_id` string, nullable: ID of the key in the HSM
    - `key_pin` string, nullable: The pin which protects the key in the hsm, if any. Note that this only the key pin, not hsm password or partition pin.

## Response `200`

OK

- StatusList
  - `id` string, uuid: Id of the status list used by the business issuer.
  - `statusRegistryUrl` string: URI of the status list used by registry.
  - `maxListEntries` integer: How many status entries can be part of the status list. The memory size of the status list is depending on the type and the config of the status list.
  - `remainingListEntries` integer: How many status entries are not used in the status list.
  - `config` object: Additional config parameters, depending on the status list type. For Example {"bits": 2} for token status list with revocation & suspension {"purpose": "suspension"} for a bit string status list for suspension

## Changes

- **2026-10-06** `d24758bc44e0`: 4 info
  - the request property `configuration_override/issuer_did` became nullable
  - the request property `configuration_override/key_id` became nullable
  - the request property `configuration_override/key_pin` became nullable
  - the request property `configuration_override/verification_method` became nullable
- **2026-05-26** `beb3cc8fa8bf`: 1 info
  - removed the non-success response with the status `404`
- **2026-03-11** `dcffaea18715`: 1 breaking, 2 warning, 1 info
  - removed the enum value `TOKEN_STATUS_LIST` of the request property `type`
  - removed the optional property `type` from the response with the `200` status
  - removed the optional property `version` from the response with the `200` status
  - the request property `type` became optional
- **2025-11-03** `ac96612dcb3b`: 1 warning
  - removed the optional property `nextFreeIndex` from the response with the `200` status
- **2025-09-25** `21bb063a1c43`: 1 breaking
  - the `config/additionalProperties/` response's property type changed from `object` to no type for status `200`

[Operation history](https://skmtc.dev/swiyu/apis/issuer-service-api/changes/management/api/status-list/post.md)

---

[API](https://skmtc.dev/swiyu/apis/issuer-service-api.md) - [All operations](https://skmtc.dev/swiyu/apis/issuer-service-api/llms.txt) - [OpenAPI document](https://skmtc.dev/swiyu/apis/issuer-service-api/revisions/f2f3fbbaf461?raw)