---
title: "Submit Overseas Return Notification"
method: POST
path: "/organisations/pillar-two/overseas-return-notification"
tags: ["submission"]
---

# Submit Overseas Return Notification

`POST /organisations/pillar-two/overseas-return-notification`

Submits an Overseas Return Notification for an accounting period.
### Error Codes
<p>This table contains a list of 422 error codes returned when a Submit Overseas Return Notification request is not processed successfully.</p> 
<table>
<thead>
<tr>
<th>Error Message</th>
<th>Next Steps</th>
</tr>
</thead>
<tbody>
<tr>
<td>003 - Request could not be processed</td>
<td>The message could not be processed due to locking. Please make the following checks. Confirm if there is currently an open enquiry on your tax account. The <em>accountingPeriodFrom</em> and <em>accountingPeriodTo</em> date range should match the period defined in your test organisation. The <em>filedDateGIR</em> date should not be in the future. The <em>countryGIR</em> and <em>issuingCountryTIN</em> fields must conform to the ISO-3166 standard for country codes. In the organisation’s settings, the <em>accountStatus</em> should have the <em>inactive</em> flag set to “false".
</td>
</tr>
<tr>
<td>044 - Tax Obligation already fulfilled</td>
<td>An ORN for the specified period has already been submitted.</td>
</tr>
<tr>
<td>063 - Business Partner does not have an Active Subscription for this Regime</td>
<td>The Pillar 2 ID in the request header is not listed as active by HMRC for this regime. Please contact the central support team.</td>
</tr>
<tr>
<td>093 - Invalid Return</td>
<td>There is an error with the return you’ve submitted in the request.</td>
</tr>
</tbody>
</table>

## Headers

- `X-Pillar2-Id` string, required
- `Authorization` string, required
- `Accept` string

## Request body

- object
  - `accountingPeriodFrom` string, date, required — The calendar date upon which a business' accounting period begins.
  - `accountingPeriodTo` string, date, required — The calendar date upon which a business' accounting period ends.
  - `filedDateGIR` string, date, required — The date upon which the GloBE Information Return (GIR) was filed or submitted.
  - `countryGIR` string, required — The country in which the GloBE Information Return (GIR) was submitted.
  - `reportingEntityName` string, required — The name of the company that submitted the GloBE Information Return (GIR).
  - `TIN` string, required — The Tax Identification Number of the entity submitting the Overseas Return Notification.
  - `issuingCountryTIN` string, required — The country in which the Tax Identification Number was issued.

## Response `201`

Overseas Return Notification Submission Created

- object
  - `processingDate` string, required — The date and time that an event took place.
  - `formBundleNumber` string, required — A unique identifier for the request, to be noted and retained in case amendments need to be filed against the return.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `422` — Business Validation Failure
- `500` — Internal Server Error

---

[API](https://skmtc.net/hmrc/apis/pillar2-submission-api.md) · [All operations](https://skmtc.net/hmrc/apis/pillar2-submission-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hmrc/pillar2-submission-api/versions/aaa66491fee8/schema)