---
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`

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 — Override to be used in place of the ISSUER_ID
    - `verification_method` string — 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 — ID of the key in the HSM
    - `key_pin` string — 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

---

[API](https://skmtc.net/swiyu/apis/issuer-service-api.md) · [All operations](https://skmtc.net/swiyu/apis/issuer-service-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/swiyu/issuer-service-api/revisions/3335603aa636/schema)