v1

latestOpenAPI 3.1.02026-07-2478315484.9 KB
Balance Raw Data

Get Balances

The Get Balances endpoint retrieves a list of balances associated with a specific bank account that has been linked by a user via LinkSDK, identified by both the entity_id and the account_id.The account_id can be found by making a call to the /accounts endpoint.Each balance object contains fields such as balance type (e.g., CLOSING_AVAILABLE, INTERIM_BOOKED, etc.), amount, currency, credit/debit indicator, and optional credit_line details that indicate available or agreed credit facilities tied to the account.Balance types can vary based on the bank and the nature of the account, and multiple types of balances may be available for the same account at the same time.Requires an active entity with the balances permission to use. A step by step guide here.

get/data/v2/accounts/{account_id}/balances

Path parameters

account_idstring uuid required

The account_id used to fetch requested data

Query parameters

asyncboolean

When true the API will return a results_id which can be fetched from the /data/v2/results endpoint when ready. Note: it's recommended to use the sync flow (async=false) for all requests by adapting the data workflow for connected entities.

pageinteger

The page you're requesting - returns page 0 of a response if not specified.

sizeinteger

The number of objects you want to return as a page size.

entity_idstring uuid

The entity_id you're querying for, which is created by LinkSDK .connect() function.

metastring

Additional data you would like to store against the request. Example: {"foo": "val"}

Response

OK

status'OK' | 'PENDING' | 'FAILED' | 'CONSENT_EXPIRED' | 'RECONNECT_REQUIRED' | 'PROCESSING_STARTED' required

The status of the request

results_idstring uuid required

The unique identifier for the request

messagestring required

A message describing the status of the request

metaobject nullable

Meta information about the request

timestampstring date-time required

The datetime of when the request was made

refreshed_atstring date-time nullable

The datetime of when the data was refreshed

typestring nullable

The endpoint the original request was made to.

Example response

{
  "data": {
    "balances": [
      {
        "amount": {
          "currency": "AED"
        },
        "credit_line": [
          {
            "amount": {
              "currency": "AED"
            }
          }
        ]
      }
    ]
  }
}