---
title: "Retrieve Obligations and Submissions"
method: GET
path: "/organisations/pillar-two/obligations-and-submissions"
tags: ["submission"]
---

# Retrieve Obligations and Submissions

`GET /organisations/pillar-two/obligations-and-submissions`

Retrieves the Obligations and Submissions for an accounting period.
### Error Codes
<p>This table contains a list of 422 error codes returned when a Retrieve Obligations and Submissions 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 check if there is currently an open enquiry on your tax account.</td>
</tr>
<tr>
<td>014 - No data found</td>
<td>No data found for this Pillar 2 ID.</td>
</tr>
<tr>
</tbody>
</table>

## Query parameters

- `fromDate` string, required
- `toDate` string, required

## Response `200`

OK Obligations and Submissions retrieved

- object
  - `processingDate` string, date-time, required
  - `accountingPeriodDetails` object[], required
    - `startDate` string, date, required
    - `endDate` string, date, required
    - `dueDate` string, date, required
    - `underEnquiry` boolean, required
    - `obligations` object[], required
      - `obligationType` 'UKTR' | 'GIR', required
      - `status` 'Open' | 'Fulfilled', required
      - `canAmend` boolean, required
      - `submissions` object[], required
        - `submissionType` 'UKTR_CREATE' | 'UKTR_AMEND' | 'ORN_CREATE' | 'ORN_AMEND' | 'BTN' | 'GIR_CREATE' | 'GIR_AMEND' | 'GIR_DELETE', required
        - `receivedDate` string, date-time, required
        - `country` string, nullable

## Other responses

- `400` — Invalid 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)