# Получение списка транзакций

Запрос для получения постраничного списка транзакций мерчанта с поддержкой фильтрации, сортировки и поиска.

***Фильтрация***

`type` – фильтрация типу транзакции: (`PAYMENT`, `TRANSFER`, `TOPUP`, `ACTIVATION`)

`invoice_id` – фильтрация по ID связанного инвойса

`from_address` – фильтрация по адресу отправителя

`to_address` – фильтрация по адресу получателя

`trn_hash` – фильтрация по хэшу транзакции

`has_aml` – фильтрация по наличию AML-проверки: (`true`, `false`)

`currency` – фильтрация по валюте инвойса (`"TRX"`, `"USDT"`)

`date_from` – отбор инвойсов, созданных начиная с указанной даты (включительно). Формат: `YYYY-MM-DD`

`date_to` – отбор инвойсов, созданных до указанной даты (включительно). Формат: `YYYY-MM-DD`

***Сортировка***

Используйте параметр `ordering` для сортировки результатов по полям `created_at`, `amount` или `status`.

Для сортировки по убыванию добавьте префикс `-`, например:

`ordering` = `-created_at`

***Пагинация***

Управляется параметрами `limit` и `offset`

Значение по умолчанию `limit`: **10**

***Поиск***

Поиск доступен по параметрам: `trn_hash`, `invoice_id`, `type`, `currency`, `from_address`, `to_address`

<mark style="color:blue;">GET</mark> [<mark style="color:$primary;">https://app.goodpayments.io/v1/api/transaction/list?date\_from=2025\_10\_25\&has\_aml=true</mark>](https://app.goodpayments.io/v1/api/transaction/list?date_from=2025_10_25\&has_aml=true)

### Заголовки&#x20;

| Имя             | Тип    | Описание                     | Пример                                                           |
| --------------- | ------ | ---------------------------- | ---------------------------------------------------------------- |
| Authorization\* | string | Уникальный API-ключ мерчанта | 94a48138b1f41b9cdb3e12c2ff0c7cbe1c7a5f50a311a5054b903cad84215662 |

### Тело запроса

Данный запрос не предполагает передачу параметров в теле. Все необходимые параметры указываются в URL-эндпойнте.

### Пример запроса

```yaml
curl -X 'GET' \
  'https://app.goodpayments.io/v1/api/transaction/list?date_from=2025_10_25&has_aml=true' \
  -H 'accept: application/json' \
  -H 'Authorization: 94a48138b1f41b9cdb3e12c2ff0c7cbe1c7a5f50a311a5054b903cad84215662'
```

### Ответ

<table><thead><tr><th>Имя</th><th width="123.71307373046875">Тип</th><th width="138.4224853515625">Описание</th><th>Пример</th></tr></thead><tbody><tr><td>trn_hash</td><td>string</td><td>Хэш транзакции</td><td>896ee1728b85a329250a6c23e73ead8491fe7220dc567b4e9912a70dc49c3e8b</td></tr><tr><td>invoice</td><td>integer</td><td>ID связанного инвойса</td><td>123477361</td></tr><tr><td>type</td><td>string</td><td>Тип транзакции. Возможные значения: <code>PAYMENT</code>, <code>TRANSFER</code>, <code>TOPUP</code>, <code>ACTIVATION</code></td><td>PAYMENT</td></tr><tr><td>from_address</td><td>string</td><td>Адрес отправителя</td><td>TFoGGb1FvETVbZxyrCk33k77jBE2yZZ5mn</td></tr><tr><td>to_address</td><td>string</td><td>Адрес получателя</td><td>TBi3zPSQ8JszpkkgwZL4kZWDjXEZsi9Fze</td></tr><tr><td>amount</td><td>number</td><td>Отправленная сумма</td><td>1</td></tr><tr><td>currency</td><td>string</td><td><p>Список принимаемых валют. Возможные значения: </p><ul><li><code>TRX</code></li><li><code>USDT</code></li></ul></td><td>"TRX"</td></tr><tr><td>aml_check</td><td>object</td><td>Результат AML проверки. Присутствует только если по транзакции проводилась проверка. Структура объекта описана ниже</td><td></td></tr><tr><td>event_id</td><td>string</td><td>UUID, связывающий входящий платеж и соответствующий исходящий перевод в рамках одного платежного события</td><td>null</td></tr><tr><td>created_at</td><td>string</td><td>Дата и время создания транзакции</td><td>2025-11-23T13:58:57.789617+00:00</td></tr></tbody></table>

#### Объект aml\_check

<table><thead><tr><th>Имя</th><th width="108.7059326171875">Тип</th><th width="147.147705078125">Описание</th><th>Пример</th></tr></thead><tbody><tr><td>id</td><td>string</td><td>Идентификатор AML-проверки</td><td></td></tr><tr><td>status</td><td>string</td><td>Статус проверки: <code>SUCCESS</code>, <code>FAILED</code>, <code>TIMEOUT</code>, <code>ERROR</code>.</td><td>SUCCESS</td></tr><tr><td>risk_score</td><td>number</td><td>Значение риска, полученное в ходе проверки</td><td>50</td></tr><tr><td>risk_level</td><td>string</td><td>Текстовое обозначение уровня риска: <code>low</code>, <code>medium</code> или <code>high</code>.</td><td>low</td></tr><tr><td>exposure</td><td>object</td><td>Объект с детализацией источников риска</td><td></td></tr><tr><td>report_url</td><td>string</td><td>URL для скачивания PDF-отчета</td><td>https://...</td></tr><tr><td>cost</td><td>number</td><td>Комиссия за AML проверку (в токене TRX)</td><td>3.1</td></tr><tr><td>completed</td><td>boolean</td><td>Завершена ли AML проверка</td><td>true</td></tr><tr><td>created_at</td><td>string</td><td>Дата и время создания проверки</td><td>2025-11-23T13:58:57.789617+00:00</td></tr></tbody></table>

### Пример ответа

{% tabs %}
{% tab title="200 Success" %}

```json
{
  "trn_hash": "896ee1728b85a329250a6c23e73ead8491fe7220dc567b4e9912a70dc49c3e8b",
  "invoice": 123477361,
  "type": "PAYMENT",
  "from_address": "TFoGGb1FvETVbZxyrCk33k77jBE2yZZ5mn",
  "to_address": "TBi3zPSQ8JszpkkgwZL4kZWDjXEZsi9Fze",
  "amount": 3.6329,
  "currency": "TRX",
  "aml_check": null,
  "event_id": null,
  "created_at": "2025-11-23T16:59:30.477619+03:00"
}
```

{% endtab %}

{% tab title="403 Authentication credentials were not provided" %}

```json
{
  "detail": "Authentication credentials were not provided."
}
```

{% endtab %}

{% tab title="404 Address not found" %}

```json
{
  "detail": "Address not found."
}
```

{% endtab %}
{% endtabs %}

### Возможные ошибки

Если заголовок с корректным API-ключом отсутствует, ключ недействителен или IP-адрес не в белом списке, сервер возвращает ответ с кодом **403**.

Если в запросе указан некорректный id, сервер возвращает ответ с кодом **404**.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-spiska-tranzakcii.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.