v1

latestOpenAPI 3.0.32026-07-134744.0 KB

create-test-user

Create a test user which is an individual

This resource creates and returns a test user which is an individual. The caller can specify the required service enrolments in the request body. If no request body is supplied, the test user is created with no service enrolments. Test users that have not been tested against within a 3-month period will be automatically deleted.

post/create-test-user/individuals

Request body

eoriNumberstring

Economic Operator Registration and Identification (EORI) number. Regular expressions:<br><code>^(GB|XI)[0-9]{12,15}$</code> A GB or XI EORI.<br><code>^[A-Z]{2}[0-9]{1,15}$</code> An EU EORI.

ninostring

National Insurance number. Must be enrolled with 'national-insurance' or 'mtd-income-tax' services for this to be used.

Response

The individual test user resource has been created.

userIdstring required

Government Gateway ID.

passwordstring required

Government Gateway password.

userFullNamestring required

Government Gateway user's full name.

emailAddressstring required

Government Gateway user's email address.

saUtrstring

Self Assessment UTR.

ninostring

National Insurance number.

mtdItIdstring

Making Tax Digital Income Tax ID.

eoriNumberstring

Economic Operator Registration and Identification (EORI) number.

vrnstring

VAT Reference Number.

vatRegistrationDatestring date

Date of registration for VAT.

All 4 operations