API

/notification

An endpoint used by GOV.UK Wallet to notify the credential issuer of events concerning issued credentials.

Status Description Schema

204

Status	Description	Schema
204	No Content
400	Bad Request `{ "error": "invalid_notification_id" }`	Notification400ErrorResponse
401	Unauthorized `{ "error": "invalid_token", "error_description": "The access token expired" }`	Notification401ErrorResponse

No Content

400

Bad Request

{
  "error": "invalid_notification_id"
}

401

Unauthorized

{
  "error": "invalid_token",
  "error_description": "The access token expired"
}

Name	Type	Required	Description	Schema
error	string	true	An error code - must be `invalid_notification_request`, `invalid_notification_id`, or `invalid_request`.
error_description	string	false	A human-readable explanation of the error.

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

This page was last reviewed on 5 March 2025. It needs to be reviewed again on 5 May 2025 .