v1

latestOpenAPI 3.0.32026-07-131435187.6 KB
Departures

Get a cached departure for a departure ID

Get a specific departure declaration sent to the customs office of departure within the past 60 days. Movements older than 60 days and their related messages are archived and cannot be returned by the API. A successful response will include a Movement Reference Number (MRN) only after it has been allocated to a movement. <br/><br/> Note: You can view a transit movement only if your Economic Operators Registration and Identification (EORI) number matches the EORI number that created the transit declaration for that movement. Your EORI number is part of the bearer token that you use for API authentication.

get/customs/transits/movements/departures/{departureId}

Path parameters

departureIdstring required

The departure ID specifying the departure to return.

Headers

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

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

Response

A successful get departure for departure ID response

idstring required
movementReferenceNumberstring
localReferenceNumberstring
createdstring required
updatedstring
enrollmentEORINumberstring required
movementEORINumberstring

Example response

{
  "_links": {
    "self": {
      "href": "/customs/transits/movements/departures/6365135ba5e821ee"
    },
    "messages": {
      "href": "/customs/transits/movements/departures/6365135ba5e821ee/messages"
    }
  },
  "id": "6365135ba5e821ee",
  "movementReferenceNumber": "ABC123",
  "localReferenceNumber": "DEF456",
  "created": "2022-11-10T15:32:51.459Z",
  "updated": "2022-11-10T15:32:51.459Z",
  "enrollmentEORINumber": "GB1234567890",
  "movementEORINumber": "GB1234567890"
}