---
title: "Send an arrival notification message"
method: POST
path: "/customs/transits/movements/arrivals"
tags: ["Arrivals"]
---

# Send an arrival notification message

`POST /customs/transits/movements/arrivals`

Notify the customs office of destination that a transit movement has arrived at its final destination.

This request is also called an ‘Arrival Notification’ E_ARR_NOT (IE007) message.
<br/><br/>
If you use this endpoint to send a small message (up to 5MB), a successful response:
- will contain a URI that you can use to get the message status
- will contain the arrival ID specifying the arrival returned
- can also include an optional box ID, which you can use to match this movement to any messages received from the Push Pull Notifications API

If you use this endpoint to send a large message (up to 8MB), a successful response will include:
- a URL and additional metadata that you must use when uploading your file
- will contain the arrival ID specifying the arrival returned
- a message ID that allows you track the status of that specific message

**Note:** If an Economic Operators Registration and Identification (EORI) number has not been assigned to you, an HTTP 403 Forbidden error is returned.

## Headers

- `Accept` 'application/vnd.hmrc.3.0+json', required
- `Content-Type` 'application/json' | 'application/xml', required

## Response `202`

Accepted

- union
  - object
    - `_links` object, required
      - `self` object, required
        - `href` string, required
      - `messages` object, required
        - `href` string, required
    - `arrivalId` string, required
    - `messageId` string, required
    - `boxId` string
  - object
    - `_links` object, required
      - `self` object, required
        - `href` string, required
      - `messages` object, required
        - `href` string, required
    - `arrivalId` string, required
    - `messageId` string, required
    - `boxId` string
    - `uploadRequest` object, required
      - `href` string, required
      - `fields` object, required

## Other responses

- `400` — Schema Validation
- `406` — Not Acceptable
- `413` — Payload Too Large

---

[API](https://skmtc.net/hmrc/apis/common-transit-convention-traders.md) · [All operations](https://skmtc.net/hmrc/apis/common-transit-convention-traders/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hmrc/common-transit-convention-traders/versions/3f42685e9ab3/schema)