--- title: "Get account details" method: GET path: "/lifetime-isa/manager/{lisaManagerReferenceNumber}/accounts/{accountId}" tags: ["LISA Accounts"] --- # Get account details `GET /lifetime-isa/manager/{lisaManagerReferenceNumber}/accounts/{accountId}` Use an account ID to get account details. ### Test data
Scenario Response

Request with a valid LISA Manager reference number and account ID (open account)

lisaManagerReferenceNumber: Use your test user profile
accountId: 1234567890

HTTP status: 200 (OK)

{
  "accountId": "1234567890",
  "investorId": "9876543210",
  "creationReason": "New",
  "firstSubscriptionDate": "2017-04-06",
  "accountStatus": "OPEN",
  "subscriptionStatus": "ACTIVE"
}

Request with a valid LISA Manager reference number and account ID (transferred account)

lisaManagerReferenceNumber: Use your test user profile
accountId: 1234567891

HTTP status: 200 (OK)

{
  "accountId": "1234567891",
  "investorId": "9876543210",
  "creationReason": "Transferred",
  "firstSubscriptionDate": "2017-04-06",
  "accountStatus": "OPEN",
  "subscriptionStatus": "AVAILABLE",
  "transferAccount": {
    "transferredFromAccountId": "8765432100",
    "transferredFromLMRN": "Z654321",
    "transferInDate": "2017-04-06"
  }
}

Request with a valid LISA Manager reference number and account ID (Current year funds transferred)

lisaManagerReferenceNumber: Use your test user profile
accountId: 1234567892

HTTP status: 200 (OK)

{
  "accountId": "1234567892",
  "investorId": "9876543210",
  "creationReason": "Current year funds transferred",
  "firstSubscriptionDate": "2017-04-06",
  "accountStatus": "OPEN",
  "subscriptionStatus": "AVAILABLE",
  "transferAccount": {
    "transferredFromAccountId": "8765432100",
    "transferredFromLMRN": "Z654321",
    "transferInDate": "2017-04-06"
  }
}

Request with a valid LISA Manager reference number and account ID (Previous year funds transferred)

lisaManagerReferenceNumber: Use your test user profile
accountId: 1234567893

HTTP status: 200 (OK)

{
  "accountId": "1234567893",
  "investorId": "9876543210",
  "creationReason": "Previous year funds transferred",
  "firstSubscriptionDate": "2017-04-06",
  "accountStatus": "OPEN",
  "subscriptionStatus": "AVAILABLE",
  "transferAccount": {
    "transferredFromAccountId": "8765432100",
    "transferredFromLMRN": "Z654321",
    "transferInDate": "2017-04-06"
  }
}

Request with a valid LISA Manager reference number and account ID (voided account)

lisaManagerReferenceNumber: Use your test user profile
accountId: 1000000200

HTTP status: 200 (OK)

{
  "accountId": "1000000200",
  "investorId": "9876543210",
  "creationReason": "New",
  "firstSubscriptionDate": "2017-04-06",
  "accountStatus": "VOID",
  "subscriptionStatus": "VOID"
}

Request with a valid LISA Manager reference number and account ID (closed account)

lisaManagerReferenceNumber: Use your test user profile
accountId: 2000000200

HTTP status: 200 (OK)

{
  "accountId": "2000000200",
  "investorId": "9876543210",
  "creationReason": "New",
  "firstSubscriptionDate": "2017-04-06",
  "accountStatus": "CLOSED",
  "subscriptionStatus": "VOID",
  "accountClosureReason": "All funds withdrawn",
  "closureDate": "2017-10-25"
}

Request with a valid account ID, but an invalid LISA Manager reference number

lisaManagerReferenceNumber: 123456
accountId: 1234567890

HTTP status: 400 (Bad Request)

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

Request with a valid LISA Manager reference number, but an invalid account ID

lisaManagerReferenceNumber: Use your test user profile
accountId: 1234%3D5678

HTTP status: 400 (Bad Request)

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

Request containing an account ID that does not exist

lisaManagerReferenceNumber: Use your test user profile
accountId: 0000000404

HTTP status: 404 (Not found)

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

Request with an invalid 'Accept' header

lisaManagerReferenceNumber: Use your test user profile
accountId: 1234567890

Accept: application/vnd.hmrc.1.0

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"
}
## Path parameters - `lisaManagerReferenceNumber` string, required - `accountId` string, required ## Headers - `Accept` 'application/vnd.hmrc.2.0+json', required - `Authorization` string, required ## Response `200` OK - object - `investorId` string, required — The investor’s ID reference number. - `accountId` string, required — The provider’s own unique reference number for the investor’s LISA account. - `creationReason` 'New' | 'Transferred' | 'Current year funds transferred' | 'Previous year funds transferred' | 'Reinstated', required — The reason the account was created. - `firstSubscriptionDate` string, required — The date of the first deposit into the account - if this is a transfer, use the date of deposit into the account managed by the previous provider. This cannot be in the future. - `accountStatus` 'OPEN' | 'VOID' | 'CLOSED', required — The status of the account. - `subscriptionStatus` 'AVAILABLE' | 'ACTIVE' | 'LOCKED' | 'CANCELLED' | 'VOID', required — The subscription status for the current tax year. - `accountClosureReason` 'All funds withdrawn' | 'Cancellation' | 'Transferred out' | 'Voided' — The reason the account was closed. - `closureDate` string — The date the account was closed. This cannot be in the future. - `transferAccount` object — Account transfer information. - `transferredFromAccountId` string, required — The previous provider’s own unique reference number for the investor’s LISA account. - `transferredFromLMRN` string, required — The reference given to the LISA provider when they applied for approval from HMRC. - `transferInDate` string, required — The date the account transferred from the previous provider to the new one. This cannot be in the future. ## 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)