---
title: "View a life event"
method: GET
path: "/lifetime-isa/manager/{lisaManagerReferenceNumber}/accounts/{accountId}/events/{lifeEventId}"
tags: ["Life Events"]
---

# View a life event

`GET /lifetime-isa/manager/{lisaManagerReferenceNumber}/accounts/{accountId}/events/{lifeEventId}`

View life event data that has been submitted to HMRC. You can view death and terminal illness, property purchase funds release, property purchase extension, property purchase outcome, and annual return of information.

### Test data

<table style="font-family:Roboto, sans-serif; font-size:14px;">
  <col width="40%">
  <col width="60%">
  <thead>
    <tr>
      <th>Scenario</th>
      <th>Response</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td>
        <p>Terminal illness life event</p>
        <p class="code--block">
          lisaManagerReferenceNumber: <a href="/api-documentation/docs/api/service/lisa-api/2.0#testing">Use your test user profile</a><br>
          accountId: 1234567890<br>
          lifeEventId: 1234567891
        </p>
      </td>
      <td>
        <p>HTTP status: <code class="code--slim">200 (OK)</code></p>
<pre class="code--block">
[
  {
    "lifeEventId": "1234567891",
    "eventType" : "LISA Investor Terminal Ill Health",
    "eventDate" : "2017-04-20"
  }
]
</pre>
      </td>
    </tr>
    <tr>
      <td>
        <p>Annual return of information which has been superseded</p>
        <p class="code--block">
          lisaManagerReferenceNumber: <a href="/api-documentation/docs/api/service/lisa-api/2.0#testing">Use your test user profile</a><br>
          accountId: 1234567890<br>
          lifeEventId: 7890000001
        </p>
      </td>
      <td>
        <p>HTTP status: <code class="code--slim">200 (OK)</code></p>
<pre class="code--block">
[
  {
    "lifeEventId": "7890000001",
    "eventType": "Statutory Submission",
    "eventDate": "2018-04-05",
    "lisaManagerName": "Company Name",
    "taxYear": 2018,
    "marketValueCash": 0,
    "marketValueStocksAndShares": 55,
    "annualSubsCash": 0,
    "annualSubsStocksAndShares": 55,
    "supersededBy": "7890000002"
  }
]
</pre>
      </td>
    </tr>
    <tr>
      <td>
        <p>Annual return of information which supersedes another</p>
        <p class="code--block">
          lisaManagerReferenceNumber: <a href="/api-documentation/docs/api/service/lisa-api/2.0#testing">Use your test user profile</a><br>
          accountId: 1234567890<br>
          lifeEventId: 7890000002
        </p>
      </td>
      <td>
        <p>HTTP status: <code class="code--slim">200 (OK)</code></p>
<pre class="code--block">
[
  {
    "lifeEventId": "7890000002",
    "eventType": "Statutory Submission",
    "eventDate": "2018-04-05",
    "lisaManagerName": "Company Name",
    "taxYear": 2018,
    "marketValueCash": 0,
    "marketValueStocksAndShares": 65,
    "annualSubsCash": 0,
    "annualSubsStocksAndShares": 65,
    "supersede": {
      "originalLifeEventId": "7890000001",
      "originalEventDate": "2018-04-05"
    }
  }
]
</pre>
      </td>
    </tr>
    <tr>
      <td>
        <p>Funds release which has been superseded</p>
        <p class="code--block">
          lisaManagerReferenceNumber: <a href="/api-documentation/docs/api/service/lisa-api/2.0#testing">Use your test user profile</a><br>
          accountId: 1234567890<br>
          lifeEventId: 3456789000
        </p>
      </td>
      <td>
        <p>HTTP status: <code class="code--slim">200 (OK)</code></p>
<pre class="code--block">
[
  {
    "lifeEventId": "3456789000",
    "eventType": "Funds release",
    "eventDate": "2017-05-10",
    "withdrawalAmount": 4000.00,
    "conveyancerReference": "CR12345-6789",
    "propertyDetails": {
      "nameOrNumber": "1",
      "postalCode": "AA11 1AA"
    },
    "supersededBy": "3456789001"
  }
]
</pre>
      </td>
    </tr>
    <tr>
      <td>
        <p>Funds release which has associated data and successful outcome</p>
        <p class="code--block">
          lisaManagerReferenceNumber: <a href="/api-documentation/docs/api/service/lisa-api/2.0#testing">Use your test user profile</a><br>
          accountId: 1234567890<br>
          lifeEventId: 3456789001
        </p>
      </td>
      <td>
        <p>HTTP status: <code class="code--slim">200 (OK)</code></p>
<pre class="code--block">
[
  {
    "lifeEventId": "3456789001",
    "eventType": "Funds release",
    "eventDate": "2017-05-05",
    "withdrawalAmount": 5000.00,
    "conveyancerReference": "CR12345-6789",
    "propertyDetails": {
      "nameOrNumber": "1",
      "postalCode": "AA11 1AA"
    },
    "supersede": {
      "originalLifeEventId": "3456789000",
      "originalEventDate": "2017-05-10"
    }
  },
  {
    "lifeEventId": "6789000002",
    "eventType": "Extension one",
    "eventDate": "2017-05-11",
    "fundReleaseId": "3456789001",
    "supersede": {
      "originalLifeEventId": "6789000001",
      "originalEventDate": "2017-05-10"
    }
  },
  {
    "lifeEventId": "6789000004",
    "eventType": "Extension two",
    "eventDate": "2017-08-11",
    "fundReleaseId": "3456789001",
    "supersede": {
      "originalLifeEventId": "6789000003",
      "originalEventDate": "2017-08-10"
    }
  },
  {
    "lifeEventId": "5678900002",
    "eventType": "Purchase outcome",
    "eventDate": "2017-10-10",
    "fundReleaseId": "3456789001",
    "propertyPurchaseValue": 250000,
    "propertyPurchaseResult": "Purchase completed",
    "supersede": {
      "originalLifeEventId": "5678900001",
      "originalEventDate": "2017-10-05"
    }
  }
]
</pre>
      </td>
    </tr>
    <tr>
      <td>
        <p>Funds release with failure outcome</p>
        <p class="code--block">
          lisaManagerReferenceNumber: <a href="/api-documentation/docs/api/service/lisa-api/2.0#testing">Use your test user profile</a><br>
          accountId: 1234567891<br>
          lifeEventId: 3456789002
        </p>
      </td>
      <td>
        <p>HTTP status: <code class="code--slim">200 (OK)</code></p>
<pre class="code--block">
[
  {
    "lifeEventId": "3456789002",
    "eventType": "Funds release",
    "eventDate": "2017-05-05",
    "withdrawalAmount": 5000.00,
    "conveyancerReference": "CR12345-6789",
    "propertyDetails": {
      "nameOrNumber": "1",
      "postalCode": "AA11 1AA"
    },
    "supersede": {
      "originalLifeEventId": "3456789000",
      "originalEventDate": "2017-05-10"
    }
  },
  {
    "lifeEventId": "5678900003",
    "eventType": "Purchase outcome",
    "eventDate": "2017-10-10",
    "fundReleaseId": "3456789002",
    "propertyPurchaseResult": "Purchase failed"
  }
]
</pre>
      </td>
    </tr>
    <tr>
      <td>
        <p>Purchase extension one which has been superseded</p>
        <p class="code--block">
          lisaManagerReferenceNumber: <a href="/api-documentation/docs/api/service/lisa-api/2.0#testing">Use your test user profile</a><br>
          accountId: 1234567890<br>
          lifeEventId: 6789000001
        </p>
      </td>
      <td>
        <p>HTTP status: <code class="code--slim">200 (OK)</code></p>
<pre class="code--block">
[
  {
    "lifeEventId": "6789000001",
    "eventType": "Extension one",
    "eventDate": "2017-05-10",
    "fundReleaseId": "3456789001",
    "supersededBy": "6789000002"
  }
]
</pre>
      </td>
    </tr>
    <tr>
      <td>
        <p>Purchase extension one which supersedes another</p>
        <p class="code--block">
          lisaManagerReferenceNumber: <a href="/api-documentation/docs/api/service/lisa-api/2.0#testing">Use your test user profile</a><br>
          accountId: 1234567890<br>
          lifeEventId: 6789000002
        </p>
      </td>
      <td>
        <p>HTTP status: <code class="code--slim">200 (OK)</code></p>
<pre class="code--block">
[
  {
    "lifeEventId": "6789000002",
    "eventType": "Extension one",
    "eventDate": "2017-05-11",
    "fundReleaseId": "3456789001",
    "supersede": {
      "originalLifeEventId": "6789000001",
      "originalEventDate": "2017-05-10"
    }
  }
]
</pre>
      </td>
    </tr>
    <tr>
      <td>
        <p>Purchase extension two which has been superseded</p>
        <p class="code--block">
          lisaManagerReferenceNumber: <a href="/api-documentation/docs/api/service/lisa-api/2.0#testing">Use your test user profile</a><br>
          accountId: 1234567890<br>
          lifeEventId: 6789000003
        </p>
      </td>
      <td>
        <p>HTTP status: <code class="code--slim">200 (OK)</code></p>
<pre class="code--block">
[
  {
    "lifeEventId": "6789000003",
    "eventType": "Extension two",
    "eventDate": "2017-08-10",
    "fundReleaseId": "3456789001",
    "supersededBy": "6789000004"
  }
]
</pre>
      </td>
    </tr>
    <tr>
      <td>
        <p>Purchase extension two which supersedes another</p>
        <p class="code--block">
          lisaManagerReferenceNumber: <a href="/api-documentation/docs/api/service/lisa-api/2.0#testing">Use your test user profile</a><br>
          accountId: 1234567890<br>
          lifeEventId: 6789000004
        </p>
      </td>
      <td>
        <p>HTTP status: <code class="code--slim">200 (OK)</code></p>
<pre class="code--block">
[
  {
    "lifeEventId": "6789000004",
    "eventType": "Extension two",
    "eventDate": "2017-08-11",
    "fundReleaseId": "3456789001",
    "supersede": {
      "originalLifeEventId": "6789000003",
      "originalEventDate": "2017-08-10"
    }
  }
]
</pre>
      </td>
    </tr>
    <tr>
      <td>
        <p>Purchase outcome which has been superseded</p>
        <p class="code--block">
          lisaManagerReferenceNumber: <a href="/api-documentation/docs/api/service/lisa-api/2.0#testing">Use your test user profile</a><br>
          accountId: 1234567890<br>
          lifeEventId: 5678900001
        </p>
      </td>
      <td>
        <p>HTTP status: <code class="code--slim">200 (OK)</code></p>
<pre class="code--block">
[
  {
    "lifeEventId": "5678900001",
    "eventType": "Purchase outcome",
    "eventDate": "2017-10-05",
    "fundReleaseId": "3456789001",
    "propertyPurchaseValue": 250000,
    "propertyPurchaseResult": "Purchase completed",
    "supersededBy": "5678900002"
  }
]
</pre>
      </td>
    </tr>
    <tr>
      <td>
        <p>Purchase outcome which supersedes another</p>
        <p class="code--block">
          lisaManagerReferenceNumber: <a href="/api-documentation/docs/api/service/lisa-api/2.0#testing">Use your test user profile</a><br>
          accountId: 1234567890<br>
          lifeEventId: 5678900002
        </p>
      </td>
      <td>
        <p>HTTP status: <code class="code--slim">200 (OK)</code></p>
<pre class="code--block">
[
  {
    "lifeEventId": "5678900002",
    "eventType": "Purchase outcome",
    "eventDate": "2017-10-10",
    "fundReleaseId": "3456789001",
    "propertyPurchaseValue": 250000,
    "propertyPurchaseResult": "Purchase completed",
    "supersede": {
      "originalLifeEventId": "5678900001",
      "originalEventDate": "2017-10-05"
    }
  }
]
</pre>
      </td>
    </tr>
    <tr>
      <td>
        <p>Purchase outcome failure</p>
        <p class="code--block">
          lisaManagerReferenceNumber: <a href="/api-documentation/docs/api/service/lisa-api/2.0#testing">Use your test user profile</a><br>
          accountId: 1234567891<br>
          lifeEventId: 5678900003
        </p>
      </td>
      <td>
        <p>HTTP status: <code class="code--slim">200 (OK)</code></p>
<pre class="code--block">
[
  {
    "lifeEventId": "5678900003",
    "eventType": "Purchase outcome",
    "eventDate": "2017-10-10",
    "fundReleaseId": "3456789002",
    "propertyPurchaseResult": "Purchase failed"
  }
]
</pre>
      </td>
    </tr>
    <tr>
      <td>
        <p>lisaManagerReferenceNumber is in the wrong format</p>
        <p class="code--block">
          lisaManagerReferenceNumber: 123456<br>
          accountId: 1234567890<br>
          lifeEventId: 1234567891
        </p>
      </td>
      <td>
        <p>HTTP status: <code class="code--slim">400 (Bad Request)</code></p>
<pre class="code--block">
  {
  "code": "BAD_REQUEST",
  "message": "Enter lisaManagerReferenceNumber in the correct format, like Z1234"
  }
</pre>
        </td>
    </tr>
    <tr>
        <td>
          <p>accountId is in the wrong format</p>
          <p class="code--block">
            lisaManagerReferenceNumber: <a href="/api-documentation/docs/api/service/lisa-api/2.0#testing">Use your test user profile</a><br>
            accountId: 1234%3D5678<br>
            lifeEventId: 1234567891
          </p>
        </td>
        <td>
          <p>HTTP status: <code class="code--slim">400 (Bad Request)</code></p>
<pre class="code--block">
{
  "code": "BAD_REQUEST",
  "message": "Enter accountId in the correct format, like ABC12345"
  }
</pre>
        </td>
    </tr>
    <tr>
      <td>
        <p>Account not found</p>
        <p class="code--block">
          lisaManagerReferenceNumber: <a href="/api-documentation/docs/api/service/lisa-api/2.0#testing">Use your test user profile</a><br>
          accountId: 0000000404<br>
          lifeEventId: 1234567891
        </p>
      </td>
      <td>
        <p>HTTP status: <code class="code--slim">404 (Not Found)</code></p>
<pre class="code--block">
{
  "code": "INVESTOR_ACCOUNTID_NOT_FOUND",
  "message": "Enter a real accountId"
}
</pre>
      </td>
    </tr>
    <tr>
      <td>
        <p>Life event not found</p>
        <p class="code--block">
          lisaManagerReferenceNumber: <a href="/api-documentation/docs/api/service/lisa-api/2.0#testing">Use your test user profile</a><br>
          accountId: 1234567890<br>
          lifeEventId: 0000000404
        </p>
      </td>
      <td>
        <p>HTTP status: <code class="code--slim">404 (Not Found)</code></p>
<pre class="code--block">
{
  "code": "LIFE_EVENT_NOT_FOUND",
  "message": "The lifeEventId does not match with HMRC’s records"
}
</pre>
      </td>
    </tr>
  </tbody>
</table>

## Path parameters

- `lisaManagerReferenceNumber` string, required
- `accountId` string, required
- `lifeEventId` string, required

## Headers

- `Accept` 'application/vnd.hmrc.2.0+json', required
- `Authorization` string, required

## Response `200`

OK

- object[]
  - `lifeEventId` string, required — The ID for the life event.
  - `eventType` 'LISA Investor Death' | 'LISA Investor Terminal Ill Health' | 'Statutory Submission' | 'Funds release' | 'Extension one' | 'Extension two' | 'Purchase outcome', required — The type of life event.
  - `eventDate` string, required — The date the life event occurred. This cannot be in the future.
  - `lisaManagerName` string — The name of the LISA provider.
  - `taxYear` integer — The tax year for the return of information. This will be the year that the tax year ends in. For example, for the 2017 to 2018 tax year it will be 2018.
  - `marketValueCash` integer — The total value that was reported for the cash LISA account.
  - `marketValueStocksAndShares` integer — The total value that was reported for the stocks and shares LISA account.
  - `annualSubsCash` integer — The total value that was reported for investor subscriptions into their cash LISA account during the tax year.
  - `annualSubsStocksAndShares` integer — The total value that was reported for investor subscriptions into their stocks and shares LISA account during the tax year.
  - `withdrawalAmount` number — This is the amount that the investor has withdrawn from the LISA account.
  - `conveyancerReference` string — This is the reference for the conveyancer involved with the property purchase.
  - `propertyDetails` object — The details of the property that you requested funds to buy.
    - `nameOrNumber` string, required — The name or number of the property that you requested funds to buy.
    - `postalCode` string, required — The postcode of the property that you requested funds to buy.
  - `fundReleaseId` string — The ID of the fund release for an extension or purchase outcome.
  - `propertyPurchaseValue` number — The value of the property that the investor purchased. Only included if the purchase was completed.
  - `propertyPurchaseResult` 'Purchase failed' | 'Purchase completed' — Whether a property purchase was completed or failed.
  - `supersede` object — Shows that a life event was corrected.
    - `originalLifeEventId` string, required — The ID of the life event that was corrected.
    - `originalEventDate` string, required — The eventDate of the life event that was corrected.
  - `supersededBy` string — The ID of the life event that supersedes the current one.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found

---

[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)