---
title: "Retrieve VAT liabilities"
method: GET
path: "/organisations/vat/{vrn}/liabilities"
tags: ["organisations"]
---

# Retrieve VAT liabilities

`GET /organisations/vat/{vrn}/liabilities`

Retrieve VAT liabilities

### Test data
<p>Scenario simulations using Gov-Test-Scenario headers are only available in sandbox environment.</p>
<table>
  <thead>
    <tr>
      <th>Header Value (Gov-Test-Scenario)</th>
      <th>Scenario</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td><p>Default (no header value)</p></td>
      <td><p>Simulates the scenario where the endpoint has indicated that no associated data could be found.</p></td>
    </tr>
    <tr>
      <td><p>SINGLE_LIABILITY</p></td>
      <td><p>Returns a single valid liability when used with dates from 2017-01-02 and to 2017-02-02.</p></td>
    </tr>
    <tr>
      <td><p>MULTIPLE_LIABILITIES</p></td>
      <td><p>Returns multiple valid liabilities when used with dates from 2017-04-05 and to 2017-12-21.</p></td>
    </tr>
    <tr>
      <td><p>SINGLE_LIABILITY_2018_19</p></td>
      <td><p>Returns a single valid liability when used with dates from 2018-01-02 and to 2018-02-02.</p></td>
    </tr>
    <tr>
      <td><p>MULTIPLE_LIABILITIES_2018_19</p></td>
      <td><p>Returns multiple valid liabilities when used with dates from 2018-04-05 and to 2018-12-21.</p></td>
    </tr>
    <tr>
      <td><p>INSOLVENT_TRADER</p></td>
      <td><p>Simulates the scenario where the client is an insolvent trader.</p></td>
    </tr>
  </tbody>
</table>
<p>The 'to' date of the liability must fall within the date range provided.</p>

## Path parameters

- `vrn` string, required

## Query parameters

- `from` string, required
- `to` string, required

## Headers

- `Gov-Test-Scenario` string

## Response `200`

- object
  - `liabilities` object[], required — A list of all liabilities
    - `taxPeriod` object — Tax Period
      - `from` string, required — Date in the format YYYY-MM-DD
      - `to` string, required — Date in the format YYYY-MM-DD
    - `type` string, required — The charge type of this liability. Max length, 30 characters.
    - `originalAmount` number, required — Defines a monetary value (to 2 decimal places), between -9,999,999,999,999.99 and 9,999,999,999,999.99
    - `outstandingAmount` number — Defines a monetary value (to 2 decimal places), between -9,999,999,999,999.99 and 9,999,999,999,999.99
    - `due` string — Date in the format YYYY-MM-DD

## Other responses

- `400`
- `403`
- `404`

---

[API](https://skmtc.dev/hmrc/apis/vat-api.md) · [All operations](https://skmtc.dev/hmrc/apis/vat-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hmrc/vat-api/revisions/e49193241753/schema)