# Список апелляций

### Метод запроса <a href="#metod-zaprosa" id="metod-zaprosa"></a>

GET

### Урл запроса <a href="#url-zaprosa" id="url-zaprosa"></a>

/v2/merchant/appeals

### Параметры запроса <a href="#parametry-zaprosa" id="parametry-zaprosa"></a>

На вход принимаются следующие параметры<br>

| Название      | Формат        | Описание                                                                                                                     |
| ------------- | ------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| transactionId | int           | Фильтр по идентификатору транзакции                                                                                          |
| status        | string(1-255) | Фильтр по статусу. Могут быть одно или несколько значений через запятую - PENDING, SUCCESS, DECLINE, CANCEL                  |
| pageNumber    | int           | Пагинация. Фильтр по номеру страницы                                                                                         |
| pageSize      | int           | Пагинация. Количество записей на странице                                                                                    |
| sortBy        | string(1-255) | Сортировка. Поле, по которому нужно отсортировать. Пример "id" - сортирует по возрастанию идентификатора, "-id" по убыванию. |

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

{% tabs %}
{% tab title="CURL" %}

```bash
curl --request GET \
  --url https://{{domain}}/v2/merchant/appeals \
  --header 'Authorization: Bearer {{your_api_token}}' \
  --header 'X-Signature: {{sign}}' \
  -d 'status=SUCCESS'
```

{% endtab %}

{% tab title="PHP + GuzzleHttp" %}

```php
$httpClient = new \GuzzleHttp\Client();
$response = $httpClient->get('https://{{domain}}//v2/merchant/appeals', [
    'query' => [
        'status' => 'SUCCESS'
    ],
    'headers' => [
        'Authorization' => 'Bearer ' . $token,
        'X-Signature' => $sign,
    ]
]);
```

{% endtab %}
{% endtabs %}

### Параметры ответа <a href="#parametry-otveta" id="parametry-otveta"></a>

<table><thead><tr><th width="299">Название</th><th>Формат</th><th>Описание</th></tr></thead><tbody><tr><td>items[].id</td><td>int</td><td>Идентификатор апелляции</td></tr><tr><td>items[].createdAt</td><td>string(1-255)</td><td>Дата создания апелляции</td></tr><tr><td>items[].status</td><td>string(1-255)</td><td>Статус апелляции (PENDING, SUCCESS, DECLINE, CANCEL)</td></tr><tr><td>items[].amount</td><td>decimal</td><td>Сумма апелляции</td></tr><tr><td>items[].transaction.id</td><td>int</td><td>Идентификатор транзакции</td></tr><tr><td>items[].transaction.amount</td><td>decimal</td><td>Сумма транзакции</td></tr><tr><td>items[].transaction.currency</td><td>string(1-255)</td><td>Код валюты ISO 4217 (RUB, UZS и т.д.)</td></tr><tr><td>items[].transaction.createdAt</td><td>string(1-255)</td><td>Дата создания транзакции</td></tr><tr><td>pageNumber</td><td>int</td><td>Номер страницы</td></tr><tr><td>pageSize</td><td>int</td><td>Количество записей на странице</td></tr><tr><td>totalCount</td><td>int</td><td>Общее количество аппеляций по выбранным фильтрам</td></tr><tr><td>pageCount</td><td>int</td><td>Количество страниц</td></tr></tbody></table>

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

```json
{
  "totalCount": 167,
  "pageCount": 167,
  "items": [
    {
      "id": 281,
      "createdAt": "2024-07-26T17:22:27.282298",
      "status": "SUCCESS",
      "amount": 1500,
      "transaction": {
        "id": 1391,
        "amount": 1500,
        "currency": "RUB",
        "createdAt": "2024-07-26T17:17:22.423825"
      }
    }
  ],
  "pageNumber": 1,
  "pageSize": 1
}
```


---

# 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://merch-int.moneyhoney.io/api/apellyacii/spisok-apellyacii.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.