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. { "index": 3, "uri": "https://crs.account.gov.uk/b/A671FED3E9AD" }	IssueResponse
400	Bad request (invalid JWT, missing fields, wrong content-type, etc.) { "error": "BAD_REQUEST", "error_description": "No Type in Header" }	Issue400ErrorResponse
401	Unauthorized (client not found) { "error": "UNAUTHORISED", "error_description": "No matching client found with ID: invalidClientId" }	Issue401ErrorResponse
403	Forbidden (JWT signature verification failure) { "error": "FORBIDDEN", "error_description": "Failure verifying the signature of the jwt" }	Issue403ErrorResponse
500	Internal server error { "error": "INTERNAL_SERVER_ERROR", "error_description": "Error receiving messages: ..." }	Issue500ErrorResponse

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 UNAUTHORISED.
error_description	string	false	A human-readable explanation of the error.

Issue403ErrorResponse

Name	Type	Required	Description	Schema
error	string	true	An error code - must be FORBIDDEN.
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.

This page was last reviewed on 22 October 2025. It needs to be reviewed again on 22 April 2026 .