---
title: "Submit an Arrival Notification Declaration"
method: POST
path: "/customs/declarations/arrival-notification"
tags: ["Endpoints"]
---

# Submit an Arrival Notification Declaration

`POST /customs/declarations/arrival-notification`

Allows submission of a Customs Arrival Notification Declaration.

**Error scenarios**

<table>
  <tbody>
    <tr>
      <td><b>Scenario</b></td>
      <td><b>HTTP Status</b></td>
      <td><b>Code</b></td>
    </tr>
    <tr>
      <td>Invalid XML Payload</td>
      <td>400 (Bad Request)</td>
      <td>BAD_REQUEST</td>
    </tr>
    <tr>
      <td>A firewall rejected the request</td>
      <td>403 (Payload Forbidden)</td>
      <td>PAYLOAD_FORBIDDEN</td>
    </tr>
    <tr>
      <td>Internal server error</td>
      <td>500 (Internal Server Error)</td>
      <td>INTERNAL_SERVER_ERROR</td>
    </tr>
  </tbody>
</table>

For error scenarios that are common across all APIs, and for error formats, see our [reference guide](/api-documentation/docs/reference-guide#errors) for more on errors.

## Headers

- `Accept` string, required
- `Content-Type` string, required
- `X-Badge-Identifier` string
- `X-Submitter-Identifier` string

## Response `202`

## Other responses

- `400`
- `403`
- `500`

---

[API](https://skmtc.net/hmrc/apis/customs-declarations-2.md) · [All operations](https://skmtc.net/hmrc/apis/customs-declarations-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hmrc/customs-declarations-2/versions/792caea0577e/schema)