--- title: "Request the release of funds to buy a property" method: POST path: "/lifetime-isa/manager/{lisaManagerReferenceNumber}/accounts/{accountId}/events/fund-releases" tags: ["Life Events"] --- # Request the release of funds to buy a property `POST /lifetime-isa/manager/{lisaManagerReferenceNumber}/accounts/{accountId}/events/fund-releases` Request the release of LISA funds to buy a property. You can also correct a request by changing the withdrawal amount or property purchase date. When you make a correction, you cannot change the property details or the conveyancer reference number. ### Test data
Scenario Request Payload Response

Fund release created

lisaManagerReferenceNumber:
Use your test user profile

accountId:
1234567890 

{
  "eventDate": "2017-05-10",
  "withdrawalAmount": 4000.00,
  "conveyancerReference": "CR12345-6789",
  "propertyDetails": {
    "nameOrNumber": "1",
    "postalCode": "AA11 1AA"
  }
}

HTTP status: 201 (Created)

{
  "status": 201,
  "success": true,
  "data": {
    "message": "Fund release created",
    "lifeEventId": "3456789000"
  }
}

Fund release superseded

lisaManagerReferenceNumber:
Use your test user profile

accountId:
1234567890 

{
  "eventDate": "2017-05-05",
  "withdrawalAmount": 5000.00,
  "supersede": {
    "originalLifeEventId": "3456789000",
    "originalEventDate": "2017-05-10"
  }
}

HTTP status: 201 (Created)

{
  "status": 201,
  "success": true,
  "data": {
    "message": "Fund release superseded",
    "lifeEventId": "3456789001"
  }
}

Invalid LISA Manager Reference Number

lisaManagerReferenceNumber:
123456

accountId:
1234567890 

{
  "eventDate": "2017-05-10",
  "withdrawalAmount": 4000.00,
  "conveyancerReference": "CR12345-6789",
  "propertyDetails": {
    "nameOrNumber": "1",
    "postalCode": "AA11 1AA"
  }
}

HTTP status: 400 (Bad Request)

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

Invalid Account ID

lisaManagerReferenceNumber:
Use your test user profile

accountId:
1234%3D5678 

{
  "eventDate": "2017-05-10",
  "withdrawalAmount": 4000.00,
  "conveyancerReference": "CR12345-6789",
  "propertyDetails": {
    "nameOrNumber": "1",
    "postalCode": "AA11 1AA"
  }
}

HTTP status: 400 (Bad Request)

{
  "code": "BAD_REQUEST",
  "message": "Enter accountId in the correct format, like ABC12345"
}

Submission has not passed validation

lisaManagerReferenceNumber:
123456

accountId:
0000000405 

{
  "eventDate": "2017-05-10",
  "withdrawalAmount": 4000.00,
  "conveyancerReference": "CR12345-6789",
  "propertyDetails": {
    "nameOrNumber": "1",
    "postalCode": "AA11 1AA"
  }
}

HTTP status: 400 (Bad Request)

{
  "code": "INVALID_PAYLOAD",
  "message": "Submission has not passed validation"
}

This LISA account is already closed

lisaManagerReferenceNumber:
Use your test user profile

accountId:
1000000403 

{
  "eventDate": "2017-05-10",
  "withdrawalAmount": 4000.00,
  "conveyancerReference": "CR12345-6789",
  "propertyDetails": {
    "nameOrNumber": "1",
    "postalCode": "AA11 1AA"
  }
}

HTTP status: 403 (Forbidden)

{
  "code": "INVESTOR_ACCOUNT_ALREADY_CLOSED",
  "message": "The LISA account is already closed"
}

This LISA account is already void

lisaManagerReferenceNumber:
Use your test user profile

accountId:
3000000403 

 
{
  "eventDate": "2017-05-10",
  "withdrawalAmount": 4000.00,
  "conveyancerReference": "CR12345-6789",
  "propertyDetails": {
    "nameOrNumber": "1",
    "postalCode": "AA11 1AA"
  }
}

HTTP status: 403 (Forbidden)

{
  "code": "INVESTOR_ACCOUNT_ALREADY_VOID",
  "message": "The LISA account is already void"
}

This LISA account is already cancelled

lisaManagerReferenceNumber:
Use your test user profile

accountId:
2000000403 

 
{
  "eventDate": "2017-05-10",
  "withdrawalAmount": 4000.00,
  "conveyancerReference": "CR12345-6789",
  "propertyDetails": {
    "nameOrNumber": "1",
    "postalCode": "AA11 1AA"
  }
}

HTTP status: 403 (Forbidden)

{
  "code": "INVESTOR_ACCOUNT_ALREADY_CANCELLED",
  "message": "The LISA account is already cancelled"
}

Account not open long enough

lisaManagerReferenceNumber:
Use your test user profile

accountId:
4000000403 

 
{
  "eventDate": "2017-05-10",
  "withdrawalAmount": 4000.00,
  "conveyancerReference": "CR12345-6789",
  "propertyDetails": {
    "nameOrNumber": "1",
    "postalCode": "AA11 1AA"
  }
}

HTTP status: 403 (Forbidden)

{
  "code": "COMPLIANCE_ERROR_ACCOUNT_NOT_OPEN_LONG_ENOUGH",
  "message": "The account has not been open for long enough"
}

Other purchase on record

lisaManagerReferenceNumber:
Use your test user profile

accountId:
6000000403 

 
{
  "eventDate": "2017-05-10",
  "withdrawalAmount": 4000.00,
  "conveyancerReference": "CR12345-6789",
  "propertyDetails": {
    "nameOrNumber": "1",
    "postalCode": "AA11 1AA"
  }
}

HTTP status: 403 (Forbidden)

{
  "code": "COMPLIANCE_ERROR_OTHER_PURCHASE_ON_RECORD",
  "message": "Another property purchase is already recorded"
}

Supersede details do not match the original request

lisaManagerReferenceNumber:
Use your test user profile

accountId:
5000000403 

{
  "eventDate": "2017-06-05",
  "withdrawalAmount": 10000.00,
  "supersede": {
    "originalLifeEventId": "3456789000",
    "originalEventDate": "2017-05-05"
  }
}

HTTP status: 403 (Forbidden)

{
  "code": "SUPERSEDED_LIFE_EVENT_MISMATCH_ERROR",
  "message": "originalLifeEventId and the originalEventDate do not match the information in the original request"
}

Invalid Data Provided

lisaManagerReferenceNumber:
Use your test user profile

accountId:
1234567890 

{
  "eventDate": "2017-05-10",
  "withdrawalAmount": 4000.00,
  "conveyancerReference": "CR12345-6789",
  "propertyDetails": {
    "nameOrNumber": "1",
    "postalCode": "AA11 1AA"
  },
  "supersede": {
    "originalLifeEventId": "3456789000",
    "originalEventDate": "2017-05-05"
  }
}

HTTP status: 403 (Forbidden)

{
  "code": "INVALID_DATA_PROVIDED",
  "message": "You can only change eventDate or withdrawalAmount when superseding a property purchase fund release"
}

Account ID does not exist

lisaManagerReferenceNumber:
Use your test user profile

accountId:
0000000404 

{
  "eventDate": "2017-05-10",
  "withdrawalAmount": 4000.00,
  "conveyancerReference": "CR12345-6789",
  "propertyDetails": {
    "nameOrNumber": "1",
    "postalCode": "AA11 1AA"
  }
}

HTTP status: 404 (Not Found)

{
  "code": "INVESTOR_ACCOUNTID_NOT_FOUND",
  "message": "Enter a real accountId"
}

The fund release you are superseding has already been superseded

lisaManagerReferenceNumber:
Use your test user profile

accountId:
1000000409 

{
  "eventDate": "2017-05-05",
  "withdrawalAmount": 4000.00,
  "supersede": {
    "originalLifeEventId": "3456789000",
    "originalEventDate": "2017-05-10"
  }
}

HTTP status: 409 (Conflict)

{
  "code": "SUPERSEDED_LIFE_EVENT_ALREADY_SUPERSEDED",
  "message": "This life event has already been superseded",
  "lifeEventId": "3456789001"
}

Fund release already exists

lisaManagerReferenceNumber:
Use your test user profile

accountId:
0000000409 

{
  "eventDate": "2017-05-10",
  "withdrawalAmount": 4000.00,
  "conveyancerReference": "CR12345-6789",
  "propertyDetails": {
    "nameOrNumber": "1",
    "postalCode": "AA11 1AA"
  }
}

HTTP status: 409 (Conflict)

{
  "code": "LIFE_EVENT_ALREADY_EXISTS",
  "message": "The investor’s life event has already been reported",
  "lifeEventId": "3456789000"
}
## Path parameters - `lisaManagerReferenceNumber` string, required - `accountId` string, required ## Headers - `Accept` 'application/vnd.hmrc.2.0+json', required - `Content-Type` 'application/json', required - `Authorization` string, required ## Request body - object - `eventDate` string, required — This is the date of the request to release funds. This cannot be in the future. - `withdrawalAmount` number, required — This is the amount that the investor has withdrawn from the LISA account. You can include a value up to 2 decimal places. - `conveyancerReference` string — This is the reference for the conveyancer involved with the property purchase. - `propertyDetails` object — The details of the property that you are requesting funds to buy. - `nameOrNumber` string, required — The name or number of the property that you are requesting funds to buy. - `postalCode` string, required — The postcode of the property that you are requesting funds to buy. - `supersede` object — Correct an existing fund release with a new eventDate and withdrawalAmount. - `originalLifeEventId` string, required — The ID of the fund release affected by the correction. - `originalEventDate` string, required — The eventDate of the fund release affected by the correction. ## 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` 'Fund release created' | 'Fund release superseded', required — A human-readable explanation for the result of the API call. - `lifeEventId` string, required — The fund release’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 - `404` — Not Found - `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)