---
title: "Retrieving a list of banking transactions related to the conversation"
method: GET
path: "/api/conversations/{conversationId}/bankTransactions"
tags: ["Bank"]
---

# Retrieving a list of banking transactions related to the conversation

`GET /api/conversations/{conversationId}/bankTransactions`

The method allows you to get user transactions, if the conversation contains them. By default, it downloads transactions for a maximum of 90 full days,
that is: today + 90 previous days. If you need a larger scope - please contact us. Transactions are returned as defined when creating the conversation.
By default, this means both crediting and debiting the account, and only transactions that have already been made (posted or pending).
Transactions are available when the appropriate callback is received, or when the _bankTransactions_ status reaches _FINISHED_.

## Query Parameters Description
The method supports the following query parameters:

| Parameter | Example | Description |
| ------- | ------- | ------- |
| page | `10` | Page number. Paging starts on page 0 (default). |
| pageSize | `10` | Number of transactions on the results page. Currently, values above 200 are treated as 200. |

## Response Content

Detailed description of returned fields:

| Parameter                             | Example | Description |
|---------------------------------------| ------- | ----------- |
| id                                    | `34df2bd6-b790-4560-9fc9-f86c86d87990`  | Unique transaction identifier |
| date | `2020-08-27T10:40:28.348Z` | Date of operation in UTC time |
| status | `PENDING` | Status of a given transaction at the time of downloading information from the bank. Allowed values: `BOOKED` - posted transaction, `PENDING` - transaction in progress, `SCHEDULED` - future transaction. Scheduled transactions appear when the `flags` field with the value` INCLUDE_SCHEDULED` was specified when creating the conversation. |
| bank | `BREXPLPW` | Bank where the transaction was performed. The value identifies the bank as the SWIFT / BIC code. |
| accountId | `PL68249000050000400075212326` | Account number where transaction was registered. |
| type | `DEBIT` | Type of transaction. Available values: `DEBIT` (account debit) and `CREDIT` (account credit) |
| amount | `1000` | Value of the transaction in a currency unit, e.g. in grosze. |
| currency | `PLN` | type of currency |
| title | `Account top-up` | Transaction title |
| sender | `Jan Kowalski` | Transaction sender |
| senderAccountId | `PL68249000050000400075212326` | Account number of the sender |
| recipient | `Jan Kowalski` | Recipient of the transaction |
| recipientAccountId | `PL32114020040000320250132522` | Account number of the receiver |
| tags | `["transfer:bank:commission", "income:crypto"]` | Transaction categories |

## Path parameters

- `conversationId` string, required

## Query parameters

- `page` integer
- `pageSize` integer

## Response `200`

Transaction list available

## Other responses

- `402` — Exhaustion of the plan or limitations related to non-payment
- `403` — Forbidden
- `404` — Conversation not found
- `410` — Conversation is unavailable
- `500` — Server side error

---

[API](https://skmtc.dev/authologic/apis/authologic-customer-api.md) · [All operations](https://skmtc.dev/authologic/apis/authologic-customer-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/authologic/authologic-customer-api/revisions/e22bf6fc51a7/schema)