Get account movements

get

https://test-api.tbcbank.ge/bab/v1/accounts/movements

Returns a paginated list of account movements/transactions based on the provided filters.
It can be used to load transaction history for a selected period, for a specific account
and currency, or to retrieve movements updated after a given timestamp.

Filter combination rules

Filter combination	Allowed	Rule
`PeriodFrom` + `PeriodTo` + paging	✅	Returns movements for the selected period.
`AccountNumber` + `AccountCurrencyCode` + `PeriodFrom` + `PeriodTo` + paging	✅	Returns movements for the selected account, currency and period.
`AccountNumber` without `AccountCurrencyCode`	❌	Account currency must be provided when account number is provided.
`AccountCurrencyCode` without `AccountNumber`	❌	Account number must be provided when account currency is provided.
`LastMovementTimeStamp` + paging	✅	Returns movements after the provided timestamp.
`LastMovementTimeStamp` + other business filters	❌	`LastMovementTimeStamp` must not be combined with account or period filters.

Query Params

AccountNumber

string

Account number / IBAN. Required together with AccountCurrencyCode when filtering by a specific account.

AccountCurrencyCode

string

Account currency ISO code, for example GEL, USD or EUR. Required when AccountNumber is provided.

PeriodFrom

date-time

Start date and time of the search period. The start of the interval is included.

PeriodTo

date-time

End date and time of the search period. The end of the interval is included.

LastMovementTimeStamp

date-time

Returns movements created or updated after the provided timestamp. This filter must not be combined with AccountNumber, AccountCurrencyCode, PeriodFrom or PeriodTo.

PageIndex

integer

≥ 0

Defaults to 0

Zero-based page index. Use 0 for the first page, 1 for the second page, and so on.

PageSize

integer

0 to 700

Defaults to 700

Number of records to return in one page. Maximum value is 700.

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

HTTP status	Code / title	Description
400	`ValidationError` / `INCORRECT_INPUT_DATA`	One or more request parameters are missing, invalid or used in an invalid combination.
400	`DomainError` / `INVALID_ACCOUNT`	The requested account and currency pair was not found or is not available to the client.
400	`DomainError` / `USER_IS_DELETED`	The user related to the API integration does not exist or is deleted.
400	`DomainError` / `USER_IS_NOT_ACTIVE`	The user related to the API integration is not active.
400	`DomainError` / `USER_IS_BLOCKED`	The user related to the API integration is blocked.

Language

Credentials

Bearer

JWT

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

application/problem+json

200Successful response with a paginated list of account movements.

403The client or linked user does not have the required permission.

500A system error occurred while processing the request.