---
title: "List All Businesses"
method: GET
path: "/individuals/business/details/{nino}/list"
---

# List All Businesses

`GET /individuals/business/details/{nino}/list`

This endpoint allows a developer to retrieve all details of a user's business income sources. The unique account 
reference (National Insurance number) must be provided.

### 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                    | Simulate a successful response with a self-employment business.                                  |
| PROPERTY                         | Simulate a successful response with a uk-property business.                                      |
| FOREIGN_PROPERTY                 | Simulate a successful response with a foreign-property business.                                 |                                                                |
| BUSINESS_AND_PROPERTY            | Simulate a successful response with a self-employment, uk-property and foreign-property business.|
| UNSPECIFIED                      | Simulate a successful response with a property-unspecified business.                             |
| NOT_FOUND                        | Simulates the scenario where no data is found.                                                   |
| STATEFUL                         | Performs a stateful list.                                                                        |

## Path parameters

- `nino` string, required

## Headers

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

## Response `200`

Success

- object — Retrieve business details response
  - `listOfBusinesses` object[], required — An array containing the details of all the business income sources held against the specified National insurance number.
    - `typeOfBusiness` 'self-employment' | 'uk-property' | 'foreign-property' | 'property-unspecified', required — The type of business income source.
    - `businessId` string, required — A unique identifier for the business income source. Previously known as selfEmploymentId.
    - `tradingType` string — The type of trading carried out by the business.
    - `tradingName` string — The trading name of the business.

## Other responses

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

---

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