---
title: "List Business Source Adjustable Summaries"
method: GET
path: "/individuals/self-assessment/adjustable-summary/{nino}/{taxYear}"
---

# List Business Source Adjustable Summaries

`GET /individuals/self-assessment/adjustable-summary/{nino}/{taxYear}`

This endpoint allows the user to generate a list of Business Source Adjustable Summaries for a given tax year. A 
filter can be set to return the summaries for a single business or business type. The National Insurance number must
be provided.

### Test data
Scenario simulation using Gov-Test-Scenario headers is only available in the sandbox environment.  

| Tax Years        | Header Value (Gov-Test-Scenario) | Scenario                                                                                                                      |
|------------------|----------------------------------|-------------------------------------------------------------------------------------------------------------------------------|
| ALL              | N/A - DEFAULT                    | Simulate a successful response containing multiple business types.                                                            |
| ALL              | SELF_EMPLOYMENT                  | Simulate a successful response containing a self-employment business.                                                         |
| ALL              | UK_PROPERTY                      | Simulate a successful response containing a UK property business.                                                             |
| Before 2025-26   | UK_PROPERTY_FHL                  | Simulate a successful response containing UK FHL property businesses.                                                         |
| ALL              | FOREIGN_PROPERTY                 | Simulate a successful response containing a foreign property business.                                                        |
| Before 2025-26   | FOREIGN_PROPERTY_FHL             | Simulate a successful response containing EEA FHL foreign property businesses.                                               |
| ALL              | NOT_FOUND                        | Simulates the scenario where no data is found.                                                                                |
| ALL              | REQUEST_CANNOT_BE_FULFILLED      | Simulates the scenario where the request cannot be fulfilled for various reasons other than the ones triggering other errors. |
| ALL              | DYNAMIC                          | The following response values will change to correspond to the values submitted in the request:<br> • businessID<br> • typeOfBusiness<br> • accountingPeriod.startdate<br> • accountingPeriod.enddate<br> • taxYear<br> • requestedDatetime<br> • adjustedDatetime<br><br> Use one of the following businessIDs for the appropriate scenario:<br> • XBIS12345678901 for a response with a self-employment business<br> • XBIS12345678902 for a response with a uk-property business<br> • XBIS12345678915 for a response with a foreign-property business<br> • XBIS12345678903 for a response with a foreign-property-fhl-eea business (2024-25 or before only)<br> • XBIS12345678904 for a response with a uk-property-fhl business (2024-25 or before only)<br>|
| ALL              | STATEFUL                         | Performs a stateful list.                                                                                                     |

## Path parameters

- `nino` string, required
- `taxYear` string, required

## Query parameters

- `typeOfBusiness` 'self-employment' | 'uk-property-fhl' | 'uk-property' | 'foreign-property-fhl-eea' | 'foreign-property'
- `businessId` string

## Headers

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

## Response `200`

Success

- union
  - object — List Business Source Adjustable Summaries Response
    - `businessSources` object[], required — The array holding Business Source Accounting Summary Entries, by business Income Source.
      - `typeOfBusiness` 'self-employment' | 'uk-property-fhl' | 'uk-property' | 'foreign-property-fhl-eea' | 'foreign-property', required — The type of business the summary calculation is for.
      - `businessId` string, required — An identifier for the business, unique to the customer.
      - `accountingPeriod` object, required — The duration of the business income source operations to be included in the tax year submission. 2019-20 is the earliest tax year to which the accounting period can be assigned. Note: <b>Accounting period start and end dates should not be displayed to users of your software.</b>
        - `startDate` string, required — The date the accounting period began.
        - `endDate` string, required — The date the accounting period finished. The accounting period must end in the tax year to which it is assigned. For MTD submissions 2019-20 is the earliest tax year in which an accounting period can end.
      - `taxYear` string, required — The tax year that the Adjustable Summary Calculation relates to.
      - `summaries` object[], required — The array holding Business Source Accounting Summary Entries.
        - `calculationId` string, required — The unique identifier of the summary calculation.
        - `requestedDateTime` string, date-time, required — The date and time this summary calculation was originally requested, prior to any adjustments.
        - `summaryStatus` 'valid' | 'invalid' | 'superseded', required — The status of this calculated summary.
        - `adjustedSummary` boolean, required — Indicates whether the original summary calculation has had adjustments applied.
        - `adjustedDateTime` string, date-time — The date and time this calculation was adjusted.
  - object — List Business Source Adjustable Summaries Response
    - `businessSources` object[], required — The array holding Business Source Accounting Summary Entries, by business Income Source.
      - `typeOfBusiness` 'self-employment' | 'uk-property' | 'foreign-property', required — The type of business the summary calculation is for.
      - `businessId` string, required — An identifier for the business, unique to the customer.
      - `accountingPeriod` object, required — The duration of the business income source operations to be included in the tax year submission. 2019-20 is the earliest tax year to which the accounting period can be assigned. Note: <b>Accounting period start and end dates should not be displayed to users of your software.</b>
        - `startDate` string, required — The date the accounting period began.
        - `endDate` string, required — The date the accounting period finished. The accounting period must end in the tax year to which it is assigned. For MTD submissions 2019-20 is the earliest tax year in which an accounting period can end.
      - `taxYear` string, required — The tax year that the Adjustable Summary Calculation relates to.
      - `summaries` object[], required — The array holding Business Source Accounting Summary Entries.
        - `calculationId` string, required — The unique identifier of the summary calculation.
        - `requestedDateTime` string, date-time, required — The date and time this summary calculation was originally requested, prior to any adjustments.
        - `summaryStatus` 'valid' | 'invalid' | 'superseded', required — The status of this calculated summary.
        - `adjustedSummary` boolean, required — Indicates whether the original summary calculation has had adjustments applied.
        - `adjustedDateTime` string, date-time — The date and time this calculation was adjusted.

## Other responses

- `400` — Bad request
- `403` — Forbidden
- `404` — Not Found
- `422` — Unprocessable Entity

---

[API](https://skmtc.net/hmrc/apis/business-source-adjustable-summary-mtd.md) · [All operations](https://skmtc.net/hmrc/apis/business-source-adjustable-summary-mtd/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hmrc/business-source-adjustable-summary-mtd/revisions/f75077f50003/schema)