Modify date of first subscription of a LISA account

Modify the date when the first deposit was paid after a LISA account was created.

Test data

<table style="font-family:Roboto, sans-serif; font-size:14px;"> <col width="25%"> <col width="35%"> <col width="40%"> <thead> <tr> <th>Scenario</th> <th>Request Payload</th> <th>Response</th> </tr> </thead> <tbody> <tr> <td>Request with a valid payload, LISA Manager reference number and account IDlisaManagerReferenceNumber: <a href="/api-documentation/docs/api/service/lisa-api/2.0#testing">Use your test user profile</a> accountId: 1234567890</td> <td> <pre class="code--block"> { "firstSubscriptionDate": "2017-05-20" } </pre> </td> <td>HTTP status: <code class="code--slim">200 (OK)</code> <pre class="code--block"> { "status": 200, "success": true, "data": { "code": "UPDATED", "message": "Successfully updated the firstSubscriptionDate for the LISA account", "accountId": "1234567890" } } </pre> </td> </tr> <tr> <td>Request with a valid payload, LISA Manager reference number and account IDlisaManagerReferenceNumber: <a href="/api-documentation/docs/api/service/lisa-api/2.0#testing">Use your test user profile</a> accountId: 1234567891</td> <td> <pre class="code--block"> { "firstSubscriptionDate": "2017-05-20" } </pre> </td> <td>HTTP status: <code class="code--slim">200 (OK)</code> <pre class="code--block"> { "status": 200, "success": true, "data": { "code": "UPDATED_AND_ACCOUNT_VOID", "message": "Successfully updated the firstSubscriptionDate for the LISA account and changed the account status to void because the investor has another account with an earlier firstSubscriptionDate", "accountId": "1234567891" } } </pre> </td> </tr> <tr> <td>Request with a valid payload and account ID, but an invalid LISA Manager reference numberlisaManagerReferenceNumber: A12345 accountId: 1234567890</td> <td> <pre class="code--block"> { "firstSubscriptionDate": "2017-05-20" } </pre> </td> <td>HTTP status: <code class="code--slim">400 (Bad Request)</code> <pre class="code--block"> { "code": "BAD_REQUEST", "message": "Enter lisaManagerReferenceNumber in the correct format, like Z1234" } </pre> </td> </tr> <tr> <td>Request with a valid payload and LISA Manager reference number, but an invalid and account IDlisaManagerReferenceNumber: <a href="/api-documentation/docs/api/service/lisa-api/2.0#testing">Use your test user profile</a> accountId: 1234%3D5678</td> <td> <pre class="code--block"> { "firstSubscriptionDate": "2017-05-20" } </pre> </td> <td>HTTP status: <code class="code--slim">400 (Bad Request)</code> <pre class="code--block"> { "code": "BAD_REQUEST", "message": "Enter accountId in the correct format, like ABC12345" } </pre> </td> </tr> <tr> <td>Request containing invalid and/or missing datalisaManagerReferenceNumber: <a href="/api-documentation/docs/api/service/lisa-api/2.0#testing">Use your test user profile</a> accountId: 1234567890</td> <td> <pre class="code--block"> { "firstSubscriptionDate": "3000-01-01" } </pre> </td> <td>HTTP status: <code class="code--slim">400 (Bad Request)</code> <pre class="code--block"> { "code": "BAD_REQUEST", "message": "Bad Request", "errors": [ { "code": "INVALID_DATE", "message": "Date is invalid", "path": "/firstSubscriptionDate" } ] } </pre> </td> </tr> <tr> <td>Request containing a first subscription date before 6 April 2017lisaManagerReferenceNumber: <a href="/api-documentation/docs/api/service/lisa-api/2.0#testing">Use your test user profile</a> accountId: 1234567890</td> <td> <pre class="code--block"> { "firstSubscriptionDate": "2017-04-05" } </pre> </td> <td>HTTP status: <code class="code--slim">403 (Forbidden)</code> <pre class="code--block"> { "code": "FORBIDDEN", "message": "There is a problem with the request data", "errors": [ { "code": "INVALID_DATE", "message": "The firstSubscriptionDate cannot be before 6 April 2017", "path": "/firstSubscriptionDate" } ] } </pre> </td> </tr> <tr> <td>Request for an account that has already been closedlisaManagerReferenceNumber: <a href="/api-documentation/docs/api/service/lisa-api/2.0#testing">Use your test user profile</a> accountId: 0000000901</td> <td> <pre class="code--block"> { "firstSubscriptionDate": "2017-05-20" } </pre> </td> <td>HTTP status: <code class="code--slim">403 (Forbidden)</code> <pre class="code--block"> { "code": "INVESTOR_ACCOUNT_ALREADY_CLOSED", "message": "The LISA account is already closed" } </pre> </td> </tr> <tr> <td>Request for an account that has already been cancelledlisaManagerReferenceNumber: <a href="/api-documentation/docs/api/service/lisa-api/2.0#testing">Use your test user profile</a> accountId: 0000000903</td> <td> <pre class="code--block"> { "firstSubscriptionDate": "2017-05-20" } </pre> </td> <td>HTTP status: <code class="code--slim">403 (Forbidden)</code> <pre class="code--block"> { "code": "INVESTOR_ACCOUNT_ALREADY_CANCELLED", "message": "The LISA account is already cancelled" } </pre> </td> </tr> <tr> <td>Request for an account that has already been voidlisaManagerReferenceNumber: <a href="/api-documentation/docs/api/service/lisa-api/2.0#testing">Use your test user profile</a> accountId: 0000000902</td> <td> <pre class="code--block"> { "firstSubscriptionDate": "2017-05-20" } </pre> </td> <td>HTTP status: <code class="code--slim">403 (Forbidden)</code> <pre class="code--block"> { "code": "INVESTOR_ACCOUNT_ALREADY_VOID", "message": "The LISA account is already void" } </pre> </td> </tr> <tr> <td>Request containing an account ID that does not existlisaManagerReferenceNumber: <a href="/api-documentation/docs/api/service/lisa-api/2.0#testing">Use your test user profile</a> accountId: 0000000404</td> <td> <pre class="code--block"> { "firstSubscriptionDate": "2017-05-20" } </pre> </td> <td>HTTP status: <code class="code--slim">404 (Not Found)</code> <pre class="code--block"> { "code": "INVESTOR_ACCOUNTID_NOT_FOUND", "message": "Enter a real accountId" } </pre> </td> </tr> <tr> <td>Request with an invalid 'Accept' headerlisaManagerReferenceNumber: <a href="/api-documentation/docs/api/service/lisa-api/2.0#testing">Use your test user profile</a> accountId: 1234567890 Accept: application/vnd.hmrc.1.0</td> <td> <pre class="code--block"> { "firstSubscriptionDate": "2017-05-20" } </pre> </td> <td>HTTP status: <code class="code--slim">404 (Not Found)</code> <pre class="code--block"> { "code": "MATCHING_RESOURCE_NOT_FOUND", "message": "A resource with the name in the request can not be found in the API" } </pre> </td> </tr> </tbody> </table>

lisaManagerReferenceNumberstring required

Example:Z1234

The reference given to the LISA provider when they applied for approval from HMRC.

accountIdstring required

Example:ABC12345

The ID for the account. This will be generated by the LISA Manager and will only be unique when used in combination with lisaManagerReferenceNumber. Any special characters should be URL encoded.

Accept'application/vnd.hmrc.2.0+json' required

Specifies the response format and the version of the API to be used.

Content-Type'application/json' required

Specifies the format of the request body, which must be JSON.

Authorizationstring required

Example:Bearer bb7fed3fe10dd235a2ccda3d50fb

An OAuth 2.0 Bearer Token with appropriate scope.

Request body

firstSubscriptionDatestring 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.

Example request

{
  "firstSubscriptionDate": "2017-05-20"
}

Response

OK

statusnumber required

The HTTP status of the result of the API call. Always 200.

successboolean required

Whether the API call was successful or not. Always true.

v1

Modify date of first subscription of a LISA account

Test data

Path parameters

Headers

Request body

Example request

Response