Skip to main content

Unsubscribe an ERN from push/pull notifications

This endpoint allows you to unsubscribe an ERN to no longer receive push/pull notifications (PPN).

Use the POST endpoint Unsubscribe an ERN to no longer receive Push/Pull notifications to unsubscribe an ERN to no longer receive Push/Pull notifications.

Requirements

The user associated with the provided bearer token must have an enrolment that matches the ERN. If no matching enrolment is found, a 403 Forbidden error will be returned.

Path parameters

Parameter Type Details
ern String The ERN to be unsubscribed from PPN

Responses

Full details of successful and unsuccessful responses and their schema can be found in the API reference on the HMRC Developer Hub.

Response code Status Details Contents
202 Successful ERN accepted Empty response
400 Unsuccessful Invalid JSON or mandatory fields missing DateTime, message, debug message
401 Unsuccessful Consignor or consignee not authorised. Invalid enrolment parameter. DateTime, message, debug message
403 Unsuccessful Consignor ID or consignee ID in submitted message is not in authorisation bearer token. DateTime, message, debug message
403 Unsuccessful Logged in ERN cannot send this message DateTime, message, debug message
500 Unsuccessful Internal server error. DateTime, EMCS Correlation ID, message, debug message
503 Unsuccessful Downstream service is unavailable. DateTime, EMCS Correlation ID, message, debug message