Sign in

v1

latestOpenAPI 3.0.32026-07-138463.8 KB
Business Income Source

Create a Test Business

This endpoint enables you to create a test business for use within the Sandbox environment.

Customers may have multiple Self-Employment businesses, but only one of each Property business is allowed. MTD supports only one accounting period per year so this must be a full tax year period, for example April 6th to April 5th. Test businesses are automatically purged from the database 7 days after creation.

post/individuals/self-assessment-test-support/business/{nino}

Path parameters

ninostring required
Example:TC663795B

National Insurance number.

Headers

Accept'application/vnd.hmrc.1.0+json' required

Specifies the response format and the version of the API to be used.

Authorizationstring required
Example:Bearer bb7fed3fe10dd235a2ccda3d50fb

An OAuth 2.0 Bearer Token with the write:self-assessment scope.

Request body

typeOfBusiness'self-employment' | 'uk-property' | 'foreign-property' | 'property-unspecified' required

The type of business income source.

tradingNamestring

The trading name of the business.

Forbidden for property businesses.

Mandatory for self-employment businesses.

firstAccountingPeriodStartDatestring YYYY-MM-DD

The first accounting period start date

firstAccountingPeriodEndDatestring YYYY-MM-DD

The first accounting period end date

accountingType'CASH' | 'ACCRUALS'

CASH if you used the cash basis, money actually received and paid out, to calculate your income and expenses. Otherwise ACCRUALS.

commencementDatestring YYYY-MM-DD

Business start date, must be in the past.

cessationDatestring YYYY-MM-DD

Business cessation date.

businessAddressLineOnestring

First line of the business address.

Forbidden for property businesses.

Mandatory for self-employment businesses.

businessAddressLineTwostring

Second line of the business address.

Forbidden for property businesses.

businessAddressLineThreestring

Third line of the business address.

Forbidden for property businesses.

businessAddressLineFourstring

Fourth line of the business address.

Forbidden for property businesses.

businessAddressPostcodestring

Business postcode.

Forbidden for property businesses.

Mandatory for self-employment businesses if businessAddressCountryCode "GB" is provided.

businessAddressCountryCodestring

The two letter code for a country must adhere to ISO 3166.

Forbidden for property businesses.

Mandatory for self-employment businesses.

Example request

{
  "tradingName": "ABC Ltd.",
  "firstAccountingPeriodStartDate": "2019-09-30",
  "firstAccountingPeriodEndDate": "2020-02-29",
  "latencyDetails": {
    "latencyEndDate": "2020-02-27",
    "taxYear1": "2018-19",
    "latencyIndicator1": "A",
    "taxYear2": "2019-20",
    "latencyIndicator2": "A"
  },
  "commencementDate": "2016-09-24",
  "cessationDate": "2020-03-24",
  "businessAddressLineOne": "1 ABC Rd.",
  "businessAddressLineTwo": "London",
  "businessAddressLineThree": "Greater London",
  "businessAddressLineFour": "United Kingdom",
  "businessAddressPostcode": "M1 1AG",
  "businessAddressCountryCode": "GB"
}

Response

Success

businessIdstring

A unique identifier for the business income source.