API

/issue

post

An endpoint to request a new status index for a GOV.UK wallet credential. This API will use the issuer’s /.well-known/jwks.json endpoint to locate the signing keys to verify the signature.

Responses

Status	Description	Schema
200	A response that contains a status index and a uri to the status list where this newly issued VALID (binary 00) status index value can be found. application/json { "idx": 3, "uri": "https://crs.account.gov.uk/b/A671FED3E9AD" }	IssueResponse
400	Bad request (invalid JWT, missing fields, wrong content-type, idempotency conflict, etc.) application/json { "error": "string", "error_description": "string" }	Issue400ErrorResponse
401	Unauthorized (authentication or signature failure) application/json { "error": "UNAUTHORIZED", "error_description": "Unauthorized Request" }	Issue401ErrorResponse
409	Conflict - concurrent request with the same idempotency key already in progress application/json { "error": "CONFLICT", "error_description": "Multiple concurrent idempotent requests in progress. Please retry after a short delay." }	Issue409ErrorResponse
500	Internal server error application/json { "error": "INTERNAL_SERVER_ERROR", "error_description": "Unable to successfully issue a status" }	Issue500ErrorResponse
503	Service temporarily unavailable application/json { "error": "TEMPORARILY_UNAVAILABLE", "error_description": "Service is temporarily unavailable" }	Issue503ErrorResponse

Schemas

IssueResponse

Name	Type	Required	Description	Schema
idx	number	true	The assigned status list index. This index position is unique within the status list identified by the URI
uri	string	true	The URI of the status list that holds the issued credential. It is used in combination with the index to retrieve the status list entry

Issue400ErrorResponse

Name	Type	Required	Description	Schema
error	string	true	An error code - must be BAD_REQUEST.
error_description	string	false	A human-readable explanation of the error.

Issue401ErrorResponse

Name	Type	Required	Description	Schema
error	string	true	An error code - must be UNAUTHORIZED.
error_description	string	false	A human-readable explanation of the error.

Issue409ErrorResponse

Name	Type	Required	Description	Schema
error	string	true	An error code - must be CONFLICT.
error_description	string	false	A human-readable explanation of the error.

Issue500ErrorResponse

Name	Type	Required	Description	Schema
error	string	true	An error code - must be INTERNAL_SERVER_ERROR.
error_description	string	false	A human-readable explanation of the error.

Issue503ErrorResponse

Name	Type	Required	Description	Schema
error	string	true	An error code - must be TEMPORARILY_UNAVAILABLE.
error_description	string	false	A human-readable explanation of the error.

This page was last reviewed on 22 May 2026. It needs to be reviewed again on 22 November 2026 by the page owner #di-mobile-wallet-tech-docs .