Token status list API

/t/{statusListIdentifier}

get

A public endpoint that returns an IETF Token Status List JWT. The list that is returned depends on the list type for the GOV.UK Wallet credential issuer agreed at the time of registration. The response has a signed JWT in one of the two supported status list formats.

Parameters

Parameter	In	Type	Required	Description
statusListIdentifier	path	string	true	Unique name representing the specific status list

Responses

Status	Description	Schema
200	OK
404	Not Found { "error": "NOT_FOUND", "error_description": "Status List not found for endpoint uri" }	StatusList404ErrorResponse
500	Internal server error { "error": "INTERNAL_SERVER_ERROR", "error_description": "..." }	StatusList500ErrorResponse

Schemas

StatusList404ErrorResponse

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

StatusList500ErrorResponse

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 .