Get single excise movement
This endpoint allows you to retrieve information about a given movement.
Use the GET endpoint Get excise movement to retrieve the status of an existing excise movement.
Requirements
You will only be able to retrieve movements where the consignor ID or consignee ID of the movement matches any of your excise reference numbers (ERNs) in the bearer token that you use for API authentication.
Path parameters
| Parameter | Type | Details |
|---|---|---|
| movementId | String | The movement ID of the movement |
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. | Movement ID, consignor ID, local reference number, consignee ID, administrative reference code, last updated |
| 401 | Unsuccessful | Consignor or Consignee not authorised. Invalid enrolment parameter. | DateTime, message, debug message |
| 403 | Unsuccessful | ERN 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 |