--- title: "Create a LISA investor" method: POST path: "/lifetime-isa/manager/{lisaManagerReferenceNumber}/investors" tags: ["LISA Investors"] --- # Create a LISA investor `POST /lifetime-isa/manager/{lisaManagerReferenceNumber}/investors` Report a new LISA investor to HMRC to generate an investor ID. If the investor already exists, you will get their reference number. ### Test data
Scenario Request Payload Response

Request with a valid payload and LISA Manager reference number

lisaManagerReferenceNumber: Use your test user profile

 
{
  "investorNINO": "AA123456A",
  "firstName": "First Name",
  "lastName": "Last Name",
  "dateOfBirth": "1985-03-25"
}

HTTP status: 201 (Created)

{
  "status": 201,
  "success": true,
  "data": {
    "message": "Investor created",
    "investorId": "9876543210"
  }
}

Request with a valid payload and an invalid LISA Manager reference number

lisaManagerReferenceNumber: 123456

 
{
  "investorNINO": "AA123456A",
  "firstName": "First Name",
  "lastName": "Last Name",
  "dateOfBirth": "1985-03-25"
}

HTTP status: 400 (Bad Request)

{
  "code": "BAD_REQUEST",
  "message": "Enter lisaManagerReferenceNumber in the correct format, like Z1234"
}

Request containing invalid and/or missing data

lisaManagerReferenceNumber: Use your test user profile

 
{
  "investorNINO": "A1234567A",
  "firstName": true,
  "dateOfBirth": "25-03-1985"
}

HTTP status: 400 (Bad Request)

{
  "code": "BAD_REQUEST",
  "message": "Bad Request",
  "errors": [
    {
      "code": "MISSING_FIELD",
      "message": "This field is required",
      "path": "/lastName"
    },
    {
      "code": "INVALID_DATE",
      "message": "Date is invalid",
      "path": "/dateOfBirth"
    },
    {
      "code": "INVALID_FORMAT",
      "message": "Invalid format has been used",
      "path": "/investorNINO"
    },
    {
      "code": "INVALID_DATA_TYPE",
      "message": "Invalid data type has been used",
      "path": "/firstName"
    }
  ]
}

Request containing investor details which do not match HMRC’s records

lisaManagerReferenceNumber: Use your test user profile

 
{
  "investorNINO": "AA111111A",
  "firstName": "First Name",
  "lastName": "Last Name",
  "dateOfBirth": "1985-03-25"
}

HTTP status: 403 (Forbidden)

{
  "code": "INVESTOR_NOT_FOUND",
  "message": "The investor details given do not match with HMRC’s records"
}

Request with an invalid 'Accept' header

lisaManagerReferenceNumber: Use your test user profile

Accept: application/vnd.hmrc.1.0

 
{
  "investorNINO": "AA123456A",
  "firstName": "First Name",
  "lastName": "Last Name",
  "dateOfBirth": "1985-03-25"
}

HTTP status: 404 (Not Found)

{
  "code": "MATCHING_RESOURCE_NOT_FOUND",
  "message": "A resource with the name in the request can not be found in the API"
}

Request containing a pre-existing investor’s details

lisaManagerReferenceNumber: Use your test user profile

 
{
  "investorNINO": "AA222222A",
  "firstName": "First Name",
  "lastName": "Last Name",
  "dateOfBirth": "1985-03-25"
}

HTTP status: 409 (Conflict)

{
  "code": "INVESTOR_ALREADY_EXISTS",
  "message": "The investor already has a record with HMRC",
  "id": "1234567890"
}
## Path parameters - `lisaManagerReferenceNumber` string, required ## Headers - `Accept` 'application/vnd.hmrc.2.0+json', required - `Content-Type` 'application/json', required - `Authorization` string, required ## Request body - object - `investorNINO` string, required — The investor’s National Insurance number. - `firstName` string, required — The investor’s first name. - `lastName` string, required — The investor’s last name. - `dateOfBirth` string, required — The investor’s date of birth. This cannot be in the future. ## Response `201` Created - object - `status` number, required — The HTTP status of the result of the API call. Always 201. - `success` boolean, required — Whether the API call was successful or not. Always true. - `data` object, required — Response details. - `message` 'Investor created', required — A human-readable explanation for the result of the API call. - `investorId` string, required — The investor’s ID reference number. You must store this ID as it is needed for other API calls. ## Other responses - `400` — Bad Request - `401` — Unauthorized - `403` — Forbidden - `409` — Conflict --- [API](https://skmtc.net/hmrc/apis/lisa-api.md) · [All operations](https://skmtc.net/hmrc/apis/lisa-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hmrc/lisa-api/revisions/689ca71752fb/schema)