Accounts

Get Accounts

Enables an AISP to retrieve a list of a PSU's accounts and information about those account(s) that the PSU has consented to.

get/accounts

Headers

x-fapi-auth-datestring

The time when the PSU last logged in with the TPP. All dates in the HTTP headers are represented as RFC 7231 Full Dates. An example is below: Sun, 10 Sep 2017 19:43:31 UTC

x-fapi-customer-ip-addressstring

The PSU's IP address if the PSU is currently logged in with the TPP.

x-fapi-interaction-idstring

An RFC4122 UID used as a correlation id.

Authorizationstring required

An Authorisation Token as per https://tools.ietf.org/html/rfc6750

x-customer-user-agentstring

Indicates the user-agent that the PSU is using.

x-client-idstring

Only used if an ASPSP requires the client ID in order to return rate limit headers.

TPPs must refer to ASPSP developer portals for further information on any rate limit policies, if the headers are supported and any additional requirements.

This header must not be used for client authentication

Response

Accounts Read

Example response

{
  "Data": {
    "Account": [
      {
        "AccountId": "22289",
        "Status": "Enabled",
        "Account": [
          {
            "Identification": "80200112344562",
            "Name": "Jane Smith",
            "LEI": "IZ9Q00LZEVUKWCQY6X15",
            "SecondaryIdentification": "87562298675897"
          }
        ],
        "StatementFrequencyAndFormat": [
          {
            "DeliveryAddress": {
              "AddressType": "BIZZ",
              "Department": "Finance",
              "SubDepartment": "Payroll",
              "StreetName": "Bank Street",
              "BuildingNumber": "11",
              "Floor": "11",
              "UnitNumber": "A88",
              "Room": "Basement 03",
              "PostBox": "PO Box 123456",
              "TownLocationName": "London",
              "DistrictName": "Greater London",
              "CareOf": "Jane Smith",
              "PostCode": "EC2N 4AG",
              "TownName": "London"
            }
          }
        ],
        "Servicer": {
          "SchemeName": "UK.OBIE.BICFI",
          "Identification": "80200112344562",
          "Name": "Agent Name"
        }
      }
    ]
  }
}

Changes

Changed in 10 of the 50 revisions of this API.1810

    • added the new SLCT enum value to the Data/Account/items/StatementFrequencyAndFormat/items/Frequency response property for the response status 200 (media type: application/json; charset=utf-8)

      response-property-enum-value-added

    • added the new SLCT enum value to the Data/Account/items/StatementFrequencyAndFormat/items/Frequency response property for the response status 200 (media type: application/json)

      response-property-enum-value-added

    • added the new SLCT enum value to the Data/Account/items/StatementFrequencyAndFormat/items/Frequency response property for the response status 200 (media type: application/jose+jwe)

      response-property-enum-value-added

    • added the new NONE enum value to the Data/Account/items/StatementFrequencyAndFormat/items/Frequency response property for the response status 200 (media type: application/json; charset=utf-8)

      response-property-enum-value-added

    • added the new NONE enum value to the Data/Account/items/StatementFrequencyAndFormat/items/Frequency response property for the response status 200 (media type: application/json)

      response-property-enum-value-added

    • added the new NONE enum value to the Data/Account/items/StatementFrequencyAndFormat/items/Frequency response property for the response status 200 (media type: application/jose+jwe)

      response-property-enum-value-added

    • removed the NONE enum value from the Data/Account/items/StatementFrequencyAndFormat/items/Frequency response property for the response status 200 (media type: application/json; charset=utf-8)

      response-property-enum-value-removed

    • removed the NONE enum value from the Data/Account/items/StatementFrequencyAndFormat/items/Frequency response property for the response status 200 (media type: application/json)

      response-property-enum-value-removed

    • removed the NONE enum value from the Data/Account/items/StatementFrequencyAndFormat/items/Frequency response property for the response status 200 (media type: application/jose+jwe)

      response-property-enum-value-removed

    • added the new NONE enum value to the Data/Account/items/StatementFrequencyAndFormat/items/Frequency response property for the response status 200 (media type: application/json; charset=utf-8)

      response-property-enum-value-added

    • added the new NONE enum value to the Data/Account/items/StatementFrequencyAndFormat/items/Frequency response property for the response status 200 (media type: application/json)

      response-property-enum-value-added

    • added the new NONE enum value to the Data/Account/items/StatementFrequencyAndFormat/items/Frequency response property for the response status 200 (media type: application/jose+jwe)

      response-property-enum-value-added

    • removed the NONE enum value from the Data/Account/items/StatementFrequencyAndFormat/items/Frequency response property for the response status 200 (media type: application/json; charset=utf-8)

      response-property-enum-value-removed

    • removed the NONE enum value from the Data/Account/items/StatementFrequencyAndFormat/items/Frequency response property for the response status 200 (media type: application/json)

      response-property-enum-value-removed

    • removed the NONE enum value from the Data/Account/items/StatementFrequencyAndFormat/items/Frequency response property for the response status 200 (media type: application/jose+jwe)

      response-property-enum-value-removed

    • added the new NONE enum value to the Data/Account/items/StatementFrequencyAndFormat/items/Frequency response property for the response status 200 (media type: application/json; charset=utf-8)

      response-property-enum-value-added

    • added the new NONE enum value to the Data/Account/items/StatementFrequencyAndFormat/items/Frequency response property for the response status 200 (media type: application/json)

      response-property-enum-value-added

    • added the new NONE enum value to the Data/Account/items/StatementFrequencyAndFormat/items/Frequency response property for the response status 200 (media type: application/jose+jwe)

      response-property-enum-value-added

    • added the new optional header request parameter x-client-id

      new-optional-request-parameter

    • added the new DCSV enum value to the Data/Account/items/StatementFrequencyAndFormat/items/Format response property for the response status 200 (media type: application/json; charset=utf-8)

      response-property-enum-value-added

    • added the new DCSV enum value to the Data/Account/items/StatementFrequencyAndFormat/items/Format response property for the response status 200 (media type: application/json)

      response-property-enum-value-added

    • added the new DCSV enum value to the Data/Account/items/StatementFrequencyAndFormat/items/Format response property for the response status 200 (media type: application/jose+jwe)

      response-property-enum-value-added

    • removed the DCSV enum value from the Data/Account/items/StatementFrequencyAndFormat/items/Format response property for the response status 200 (media type: application/json; charset=utf-8)

      response-property-enum-value-removed

    • removed the DCSV enum value from the Data/Account/items/StatementFrequencyAndFormat/items/Format response property for the response status 200 (media type: application/json)

      response-property-enum-value-removed

    • removed the DCSV enum value from the Data/Account/items/StatementFrequencyAndFormat/items/Format response property for the response status 200 (media type: application/jose+jwe)

      response-property-enum-value-removed

    • added the new DCSV enum value to the Data/Account/items/StatementFrequencyAndFormat/items/Format response property for the response status 200 (media type: application/json; charset=utf-8)

      response-property-enum-value-added

    • added the new DCSV enum value to the Data/Account/items/StatementFrequencyAndFormat/items/Format response property for the response status 200 (media type: application/json)

      response-property-enum-value-added

    • added the new DCSV enum value to the Data/Account/items/StatementFrequencyAndFormat/items/Format response property for the response status 200 (media type: application/jose+jwe)

      response-property-enum-value-added