---
title: "Retrieve Business Details"
method: GET
path: "/individuals/business/details/{nino}/{businessId}"
---

# Retrieve Business Details

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

This endpoint allows a developer to retrieve additional information for one of a user's business income source. The 
unique account reference (National Insurance number) must be provided as well as the unique business identifier.

### Test data
Scenario simulations using <code>Gov-Test-Scenario</code> 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. <br/> Use the following businessId for this scenario: <br/> - XBIS12345678901 |
| PROPERTY | Simulate a successful response with a uk-property business. <br/> Use the following businessId for this scenario: <br/> - XPIS12345678901 |
| FOREIGN_PROPERTY | Simulate a successful response with a foreign-property business. <br/> Use the following businessId for this scenario: <br/> - XFIS12345678901 |
| UNSPECIFIED | Simulate a successful response with a property-unspecified business. <br/> Use the following businessId for this scenario: <br/> - XAIS12345678901 |
| NOT_FOUND | Simulate a scenario where no data is found. |
| DYNAMIC | Returns a dynamic response where the type of response will change corresponding to the businessId provided in the request: <br/> - For a response with a self-employment business, use businessId: <br/>   -- XBIS12345678901 <br/> - For a response with a uk-property business, use businessId: <br/>   -- XPIS12345678901 <br/> - For a response with a foreign-property business, use businessId: <br/>   -- XFIS12345678901 <br/> - For a response with a property-unspecified business, use businessId: <br/>   -- XAIS12345678901 |
| STATEFUL | Performs a stateful retrieve. |

## Path parameters

- `nino` string, required
- `businessId` 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
  - `businessId` string, required — A unique identifier for the business income source. Previously known as selfEmploymentId.
  - `typeOfBusiness` 'self-employment' | 'uk-property' | 'foreign-property' | 'property-unspecified', required — The type of business income source.
  - `tradingName` string — The trading name of the business.
  - `yearOfMigration` string, yyyy — Year of migration.
  - `firstAccountingPeriodStartDate` string, yyyy-MM-DD — The first accounting period start date. Note: <b>Accounting period start and end dates should not be displayed to users of your software.</b>
  - `firstAccountingPeriodEndDate` string, yyyy-MM-DD — The first accounting period end date. Note: <b>Accounting period start and end dates should not be displayed to users of your software.</b>
  - `latencyDetails` object — Income source latency details.
    - `latencyEndDate` string, YYYY-MM-DD, required — End date of latency period for the income source.
    - `taxYear1` string, YYYY-YY, required — First tax year for the income source.
    - `latencyIndicator1` 'A' | 'Q', required — Self assessment submission frequency.
    - `taxYear2` string, YYYY-YY, required — Second tax year for the income source.
    - `latencyIndicator2` 'A' | 'Q', required — Self assessment submission frequency.
  - `quarterlyTypeChoice` object — Quarterly reporting period type.
    - `quarterlyPeriodType` 'standard' | 'calendar' — The quarterly period type that is being chosen for the business ID.
    - `taxYearOfChoice` string — The tax year for which the quarterly period type was chosen.
  - `accountingPeriods` object[] — The start and end dates of the latest accounting period for the business. This array contains dates for the latest accounting period only. Note: <b>Accounting period start and end dates should not be displayed to users of your software.</b>
    - `start` string, required — Date your books or accounts start - the beginning of your accounting period.
    - `end` string, required — Date your books or accounts are made up to - the end of your accounting period.
  - `commencementDate` string — Business start date, must be in the past.
  - `cessationDate` string — Business cessation date.
  - `businessAddressLineOne` string — First line of the business address.
  - `businessAddressLineTwo` string — Second line of the business address.
  - `businessAddressLineThree` string — Third line of the business address.
  - `businessAddressLineFour` string — Fourth line of the business address.
  - `businessAddressPostcode` string — Business code.
  - `businessAddressCountryCode` string — ISO country code for the business if it is in a non-GB country. The two-letter code for a country must adhere to ISO 3166.

## Other responses

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

---

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