---
title: "Retrieve History of a Self Assessment Charge"
method: GET
path: "/accounts/self-assessment/{nino}/charges/{transactionId}"
tags: ["Payments and Liabilities"]
---

# Retrieve History of a Self Assessment Charge

`GET /accounts/self-assessment/{nino}/charges/{transactionId}`

This endpoint enables you to retrieve the history of changes to an individual charge. A National Insurance number and transaction ID must be provided. 
You can get the transaction ID using the Retrieve Self Assessment Balance and Transactions endpoint - it is returned as documentId in the documentDetails array.
    
### Test data
Scenario simulation using Gov-Test-Scenario headers is only available in the sandbox environment.

| Header Value (Gov-Test-Scenario) | Scenario                                       |
|----------------------------------|------------------------------------------------|
| N/A - DEFAULT                    | Simulates success response.                    |
| NOT_FOUND                        | Simulates the scenario where no data is found. |

## Path parameters

- `nino` string, required
- `transactionId` string, required

## Headers

- `Accept` 'application/vnd.hmrc.4.0+json', required
- `Authorization` string, required
- `Gov-Test-Scenario` string

## Response `200`

Success

- object — This endpoint enables you to retrieve the history of changes to a single charge made by HMRC. A National Insurance number and transaction ID must be provided.
  - `chargeHistoryDetails` object[], required — A list of changes to a particular charge
    - `taxYear` string, date — The tax year that this charge relates to in the format: YYYY-YY.
    - `transactionId` string, required — A unique identifier used to return a single charge. Must conform to the regular expression ^[A-Za-z0-9]{1,12}$
    - `transactionDate` string, date, required — The date the charge was created in the format: YYYY-MM-DD.
    - `description` string, required — Primary method to identify what type of charge has been called.
    - `totalAmount` number, required — The value of the charge following the change. The value must be between -99999999999.99 and 99999999999.99 up to 2 decimal places.
    - `changeDate` string, date, required — The date the charge was changed, in the format: YYYY-MM-DD. This field is deprecated and will be removed in a future release. Use changeTimestamp instead.
    - `changeTimestamp` string, date-time, required — The timestamp the charge was changed, in the format: YYYY-MM-DDThh:mm:ss.SSSZ
    - `changeReason` string, required — The reason for the change.
    - `poaAdjustmentReason` string — A numeric code indicating the reason for adjustment to Payments on Account. The possible values (with their meanings) are: 001: Profits for the business are down/the business has ceased 002: Other income has gone down 003: Tax Allowances and reliefs have gone up 004: Tax deducted at source is more than previous year 005: Increasing the PoA after a prior adjustment For example: 004

## Other responses

- `400` — Bad request
- `403` — Forbidden
- `404` — Not found

---

[API](https://skmtc.net/hmrc/apis/self-assessment-accounts-api.md) · [All operations](https://skmtc.net/hmrc/apis/self-assessment-accounts-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hmrc/self-assessment-accounts-api/revisions/beec40556a41/schema)