---
title: "Retrieve financial details"
method: GET
path: "/organisations/vat/{vrn}/financial-details/{penaltyChargeReference}"
tags: ["organisations"]
---

# Retrieve financial details

`GET /organisations/vat/{vrn}/financial-details/{penaltyChargeReference}`

## Request

- Base URL: `https://test-api.service.hmrc.gov.uk`
- URL: `https://test-api.service.hmrc.gov.uk/organisations/vat/{vrn}/financial-details/{penaltyChargeReference}`
- Auth: OAuth 2
  - Authorization code: `https://api.service.hmrc.gov.uk/oauth/authorize`
  - Token URL: `https://api.service.hmrc.gov.uk/oauth/token` scopes: `read:vat`
- TypeScript: <https://skmtc.dev/hmrc/apis/vat-api/docs/organisations/vat/:vrn/financial-details/:penaltyChargeReference/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves the financial details relating to a late submission or late payment penalty that has been applied to a VAT account.

### 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</p></td>
      <td><p>The default scenario.</p></td>
    </tr> 
  </tbody>
</table>

## Path parameters

- `vrn` string, required
- `penaltyChargeReference` string, required

## Headers

- `Gov-Test-Scenario` string

## Response `200`

- object
  - `totalisations` object: Totals that relate to the charge.
    - `totalOverdue` number: The charge amount that is overdue (collectable now). The value must be between -99999999999.99 and 99999999999.99 to 2 decimal places.
    - `totalNotYetDue` number: The charge amount that has been posted to the account, but is not yet overdue. The due date is today or in the future. The value must be between -99999999999.99 and 99999999999.99 to 2 decimal places.
    - `totalBalance` number: The net charge amount (the amount that is overdue, minus any credit that is in the account). The value must be between -99999999999.99 and 99999999999.99 to 2 decimal places.
    - `totalCredit` number: Credit that is in the individual's or organisation's account, which has not yet been allocated to any charges. The value must be between -99999999999.99 and 99999999999.99 to 2 decimal places.
    - `totalCleared` number: The amount that has been paid, reversed, removed or cleared. The value must be between -99999999999.99 and 99999999999.99 to 2 decimal places.
    - `additionalReceivableTotalisations` object: Interest totals that relate to the VAT account.
      - `totalAccountPostedInterest` number: The total amount of interest that HMRC has actually posted to the account.
      - `totalAccountAccruingInterest` number: The total amount of unposted interest that the account has currently accrued.
  - `documentDetails` object[]: All the documents that relate to the charge. An individual document will only relate to one charge reference, but there could be multiple documents relating to that charge reference. For example, this might be the case if a charge has been levied and subsequently reversed, or if multiple periodic interest charges share the same charge reference.
    - `postingDate` string: The date that the charge was posted to the individual's or organisation's account.
    - `issueDate` string: The date that correspondence about the charge was sent to the individual or organisation.
    - `documentInterestTotals` object: Interest totals that relate to the charge.
      - `interestPostedAmount` number: The amount of interest, relating to the charge, that HMRC has actually posted to the account.
      - `interestAccruingAmount` number: The amount of unposted interest that has currently accrued on the charge.
    - `documentTotalAmount` number: The total sum of the line items within the document. The value must be between -99999999999.99 and 99999999999.99 to 2 decimal places.
    - `documentClearedAmount` number: The amount that has been paid, reversed, removed or cleared. For example, this could be the portion of a charge that has already been paid. The value must be between -99999999999.99 and 99999999999.99 to 2 decimal places.
    - `documentOutstandingAmount` number: The remaining balance. The value must be between -99999999999.99 and 99999999999.99 to 2 decimal places.
    - `lineItemDetails` object[]: The line items that make up the document. A document can contain more than one line item. For example, an individual or organisation might submit an amendment form that contains multiple corrections (perhaps the individual or organisation paid too much VAT for one tax period, but not enough for the next). Each correction will comprise an individual line item. HMRC will take all of the line items into account when it calculates the charge.
      - `chargeDescription` string: Describes what the charge relates to.
      - `periodFromDate` string: The start date of this period.
      - `periodToDate` string: The end date of this period.
      - `netDueDate` string: The due date for payment.
      - `amount` number: The amount. The value must be between -99999999999.99 and 99999999999.99 to 2 decimal places.
      - `lineItemInterestDetails` object: Details of the interest that relates to the line item.
        - `interestStartDate` string: The date that the interest charges started.
        - `currentInterestRate` number: The rate of interest that currently applies to the line item.
        - `interestPostedAmount` number: The amount of interest, relating to the line item, that HMRC has actually posted to the account. Interest will continue to be posted at the end of each month, until the customer pays the charge upon which the interest is based. At this point, a final interest charge will be calculated and posted.
        - `interestAccruingAmount` number: The amount of unposted interest that has accrued on the line item to date, since the interest start date.

## 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.dev/hmrc/apis/vat-api/revisions/e49193241753?raw)