Get Account Movements

The Account Movements service is used to retrieve the list of transactions performed on an account.

Data is returned in pages; the maximum number of records returned in one response is 700.

The response also returns the total number of transactions matching the filter (total).

Endpoint

GET /bab/v1/accounts/movements

Query Parameters

Parameter	Type	Description
AccountNumber	string	Account number / IBAN
AccountCurrencyCode	string	Account currency Required if AccountNumber is provided
PeriodFrom	date-time	Start date of the period
PeriodTo	date-time	End date of the period
LastMovementTimeStamp	date-time	Returns transactions after the specified date
PageIndex	integer	Page index, starts from 0
PageSize	integer	Number of transactions to return in one response. Maximum 700

Response Parameters

Field	Type	Description
transactions	array / Movement	List of transactions
pager	array / Pager	Paging information
total	integer	Total number of transactions matching the filter

Movement object

Field	Type	Description
movementId	string	Unique transaction identifier
paymentId	string / null	Returned only for transactions created through the API Integration service. This value helps the client identify transfers created from the ERP system. In other cases, the value will be null. For transactions created before February 2024, the value will always be null.
externalPaymentId	string	Id of the payment order based on which the transaction was created, if assigned by a non-digital channel, for example POS Terminal, PAYBOX, ATM or cash operation
amount	number	Numeric value of the transaction amount
currency	string	ISO currency code
purpose	string	Transaction purpose / description
isDebit	boolean	Indicates whether the transaction is debit
customerAccountInfo	object / CustomerAccountInfo	Client account information
documentDate	date-time	Document date
exchangeRate	string / null	Conversion rate if the transaction is related to currency conversion. If not applicable, null is returned.
additionalInformation	string / null	Additional information about the transaction
opCode	string / null	Operation code
partnerAccountInfo	object / PartnerAccountInfo	Partner account, bank and identification information
intermediaryBankCode	string / null	Intermediary bank code, if available
intermediaryBankName	string / null	Intermediary bank name, if available
statusCode	integer	Transaction status
date	date-time	Transaction date
parentExternalPaymentId	integer	Parent external payment identifier. This field may be filled for commission transactions linking the commission to the main transaction.
transactionReference	string / null	Transaction reference
additionalDescription	string / null	Additional description
documentNumber	string / null	Document number
chargeDetail	string / null	Commission charge detail for SWIFT payments. Possible values are SHA or OUR.
taxpayerCode	string / null	Taxpayer identification / tax code
taxpayerName	string / null	Taxpayer name
transactionType	integer	Transaction type

CustomerAccountInfo object

Field	Type	Description
accountName	string / null	Account name
accountIban	string / null	Account number / IBAN

PartnerAccountInfo object

Field	Type	Description
accountIban	string / null	Partner account number / IBAN
bankCode	string / null	Partner bank code
bankName	string / null	Partner bank name
treasuryCode	string / null	Treasury code for budget payments
partnerName	string / null	Partner name
docTypeId	integer / null	Partner identification document type code for cash operations
personalNumber	string / null	Partner personal number for cash operations
documentNumber	string / null	Partner identification document number for cash operations
taxCode	string / null	Partner identification / tax code

Pager object

Field	Type	Description
pageIndex	integer	Current page index
pageSize	integer	Number of records returned on one page. Maximum value is 700.

Transaction Types

Code	Description
1	Transfer between own accounts
5	Currency conversion
20	Credit / income
30	Outgoing transfer or cash withdrawal type operation
31	Utility payment, mobile top-up, fine or similar payment
32	Budget transfer
33	Other expense, including commission

Status Codes

statusCode indicates the authorization status of the transaction.

Code	Description
0	Authorized
1	Waiting for second authorization
2	Waiting for authorization

Identification Document Types

Code	Description
0	Without passport
1	Georgian citizen ID
2	Georgian citizen passport
3	Other countries citizen passport
4	Permanent residence permit ID
5	Soviet union passport
6	Birth certificate
8	Refugee ID
9	IDP Temporary Document
10	Temporary ID for citizen of Georgia
11	ID Card
12	ID Card - residence permit ID
13	Georgian living abroad ID
14	Diplomatic card
15	Neutral ID
16	Neutral travel document
17	Travel document
18	Diplomatic passport for Georgian citizen
19	Job passport for Georgian citizen
20	Temporary ID card
21	Unidentified
22	ID Card - temporary residence permit electronic ID

Filter Combination Rules

Parameter	Type	Description
PeriodFrom + PeriodTo + PageIndex/PageSize	✅	Returns transactions in the specified period
AccountNumber + AccountCurrencyCode + PeriodFrom + PeriodTo + PageIndex/PageSize	✅	Returns transactions for a specific account and currency
AccountNumber without currency	❌	Returns a validation error
LastMovementTimeStamp + PageIndex/PageSize	✅	Returns transactions after the timestamp
LastMovementTimeStamp + other business filter	❌	No other business filter can be filled together with LastMovementTimeStamp

Request / Response Examples

Get transactions by period:

GET {BASE_URL}/bab/v1/accounts/movements?PeriodFrom=2026-04-01T00:00:00&PeriodTo=2026-04- 30T23:59:59&PageIndex=0&PageSize=700

Get transactions by account, currency and period:

GET {BASE_URL}/bab/v1/accounts/movements?AccountNumber=GE29TB1234567890123456&AccountCurrencyCode=GEL&PeriodFrom=2026-04-01T00:00:00&PeriodTo=2026-04-30T23:59:59&PageIndex=0&PageSize=700

Get transactions by LastMovementTimeStamp:

GET {BASE_URL}/bab/v1/accounts/movements?LastMovementTimeStamp=2026-04-01T15:23:12&PageIndex=0&PageSize=700

Get next page:

GET {BASE_URL}/bab/v1/accounts/movements?PeriodFrom=2026-04-01T00:00:00&PeriodTo=2026-04-30T23:59:59&PageIndex=1&PageSize=700

{
    "transactions": [
        {
            "movementId": "018745219864.1",
            "paymentId": null,
            "externalPaymentId": "18745219864",
            "amount": 1280.75,
            "currency": "GEL",
            "purpose": "Invoice payment",
            "isDebit": true,
            "customerAccountInfo": {
                "accountName": "Test Company LLC",
                "accountIban": "GE29TB1234567890123456"
            },
            "documentDate": "2026-04-22T00:00:00",
            "exchangeRate": null,
            "additionalInformation": "Test Partner LLC TBCBGE22 GE61TB9876543210987654 Invoice #INV-2026-042",
            "opCode": "GIB",
            "partnerAccountInfo": {
                "accountIban": "GE61TB9876543210987654",
                "bankCode": "TBCBGE22",
                "bankName": "JSC TBC Bank",
                "treasuryCode": null,
                "partnerName": "Test Partner LLC",
                "docTypeId": null,
                "personalNumber": null,
                "documentNumber": null,
                "taxCode": "204567891"
            },
            "intermediaryBankCode": null,
            "intermediaryBankName": null,
            "statusCode": 0,
            "date": "2026-04-22T00:00:00",
            "parentExternalPaymentId": 0,
            "transactionReference": "TRN-2026-874521",
            "additionalDescription": "Invoice #INV-2026-042",
            "documentNumber": "DOC-452198",
            "chargeDetail": null,
            "taxpayerCode": "204123456",
            "taxpayerName": "Test Company LLC",
            "transactionType": 30
        }
    ],
    "pager": [
        {
            "pageIndex": 0,
            "pageSize": 700
        }
    ],
    "total": 1500
}