v1

latestOpenAPI 3.0.32026-07-13945127.2 KB
Movements

Get excise movements

Get excise movements. </br></br>Note: 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.

get/customs/excise/movements

Query parameters

ernstring

Filter excise movements by excise reference number (consignor ID/consignee ID). If you do not provide an excise reference number (ERN) as a query parameter, you will get a list for all ERNs in your bearer token.

arcstring

Filter excise movements by administrative reference code (ARC). This will return one movement in the list.

lrnstring

Filter excise movements by local reference number (LRN)

updatedSincestring date-time

Filter excise movements modified after provided timestamp.<br/>This can be used to poll for any updated movements.<br/>For each updated movement that gets returned, you can then call the get messages endpoint and pass in the same value for its "updatedSince" query parameter to get the messages that have been received since you last polled.

traderType'consignor' | 'consignee'

The type of trader (consignor or consignee)

Filter excise movements by trader type (consignor or consignee)

Headers

Accept'application/vnd.hmrc.1.0+json' required

Specifies the response format and the version of the API to be used.

Response

Successful operation. If there are no movements for any of your excise reference numbers (ERNs) in your bearer token or because of the filters, this will return an empty list.