Balances

Get Balances

get

Required scopes

This endpoint requires the following scopes:

• : Ability to read Accounts information

Authorizations

PSUOAuth2Security

OAuth2authorizationCodeRequired

Authorization URL: Token URL:

Path parameters

AccountIdstringRequired

AccountId

Header parameters

x-fapi-financial-idstringRequired

The unique id of the ASPSP to which the request is issued. The unique id will be issued by OB.

x-fapi-customer-last-logged-timestringOptional

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

Pattern: ^(Mon|Tue|Wed|Thu|Fri|Sat|Sun), \d{2} (Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec) \d{4} \d{2}:\d{2}:\d{2} (GMT|UTC)$

x-fapi-customer-ip-addressstringOptional

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

x-fapi-interaction-idstringOptional

An RFC4122 UID used as a correlation id.

AuthorizationstringOptional

An Authorisation Token as per https://tools.ietf.org/html/rfc6750 - required for API calls but may be ommited when using Swagger UI where the "Authorize" function has been operated

x-customer-user-agentstringOptional

Indicates the user-agent that the PSU is using.

Responses

200

Balances Read

application/json; charset=utf-8

400

Bad request

application/json; charset=utf-8

401

Unauthorized

403

Forbidden

405

Method Not Allowed

406

Not Acceptable

429

Too Many Requests

500

Internal Server Error

application/json; charset=utf-8

get

/accounts/{AccountId}/balances

HTTPcURLJavaScriptPython

GET /algbra/open-banking/v3.1/aisp/accounts/{AccountId}/balances HTTP/1.1
Host: secure.tell.systems
Authorization: Bearer YOUR_OAUTH2_TOKEN
x-fapi-financial-id: text
Accept: */*

{
  "Data": {
    "Balance": [
      {
        "AccountId": "text",
        "CreditDebitIndicator": "Credit",
        "Type": "ClosingAvailable",
        "DateTime": "2026-02-03T12:44:07.805Z",
        "Amount": {
          "Amount": "text",
          "Currency": "text"
        },
        "CreditLine": [
          {
            "Included": true,
            "Type": "Available",
            "Amount": {
              "Amount": "text",
              "Currency": "text"
            }
          }
        ]
      }
    ]
  },
  "Links": {
    "Self": "https://example.com",
    "First": "https://example.com",
    "Prev": "https://example.com",
    "Next": "https://example.com",
    "Last": "https://example.com"
  },
  "Meta": {
    "TotalPages": 1,
    "FirstAvailableDateTime": "2026-02-03T12:44:07.805Z",
    "LastAvailableDateTime": "2026-02-03T12:44:07.805Z"
  }
}