Get a message for an excise movement using the movement ID and message ID
Use the GET endpoint Get a messages for an excise movement using the movement ID and message ID to get a message belonging to a specific excise movement.
Requirements
The consignor ID or consignee ID of the movement must match an excise reference number (ERN) in the bearer token that you use for API authentication. If it does not, a 403 Forbidden error will be thrown.
Path parameters
Parameters must be entered in lowercase.
| Parameter | Type | Details |
|---|---|---|
| movementId | string | The movement ID of the movement |
| messageId | string | The message ID of the message |
Query parameters
Messages
You can receive one of the following message types from this endpoint:
| Message | Schema link | Example link |
|---|---|---|
| IE704 - Generic refusal message | IE704 XSD | IE704 XML |
| IE801 - E-AD/E-SAD container | IE801 XSD | IE801 XML |
| IE802 - Reminder Message for Excise Movement | IE802 XSD | IE802 XML |
| IE803 - Notification of Diverted E-AD/E-SAD | IE803 XSD | IE803 XML |
| IE807 - Interruption of Movement | IE807 XSD | IE807 XML |
| IE810 - Cancellation | IE810 XSD | IE810 XML |
| IE813 - Change of destination | IE813 XSD | IE813 XML |
| IE818 - Report of receipt | IE818 XSD | IE818 XML |
| IE819 - Alert or rejection of E-AD/E-SAD | IE819 XSD | IE819 XML |
| IE829 - Notification of Accepted Export | IE829 XSD | IE829 XML |
| IE837 - Explain delay to delivery | IE837 XSD | IE837 XML Consignee |
| IE839 - Refusal by Customs | IE839 XSD | IE839 XML |
| IE840 - Event Report Envelope | IE840 XSD | IE840 XML |
| IE871 - Reason for shortage | IE871 XSD | IE871 XML |
| IE881 - Manual Closure Response | IE881 XSD | IE881 XML |
| IE905 - Status Response | IE905 XSD | IE905 XML |
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 |
|---|---|---|---|
| 200 | Successful | Successful operation | Xml message format (for schema of each message see above) |
| 400 | Unsuccessful | Invalid movement ID | DateTime, message, debug message |
| 401 | Unsuccessful | Consignor or Consignee not authorised. Invalid enrolment parameter | DateTime, message, debug message |
| 403 | Unsuccessful | The requested movement’s consignor ID or consignee ID is not in authorisation bearer token | DateTime, message, debug message |
| 404 | Unsuccessful | Movement with supplied ID not found for this ERN | DateTime, message, debug message |
| 404 | Unsuccessful | Message with supplied ID not found for this ERN | DateTime, message, debug message |
| 406 | Unsuccessful | Accepted header is not acceptable | DateTime, message, debug message |