> ## Documentation Index
> Fetch the complete documentation index at: https://oblodai.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# POST /v1/payout/history

История выплат мерчанта — новые сверху, с limit/offset‑пагинацией.

**URL:** `https://api.oblodai.com/v1/payout/history` · **Аутентификация:** обязательна.

<Note>
  Примеры используют хелпер `call()` и переменные `$SECRET`/`$PUBLIC_ID` — их определение см. в
  [Как подписать запрос](/guides/signing-requests). Проще не писать подпись руками, а взять
  [SDK](/sdk/overview).
</Note>

***

## Параметры запроса

Все поля опциональны.

<ParamField body="limit" type="int64" default={25}>
  Размер страницы. По умолчанию 25, максимум 100.
</ParamField>

<ParamField body="offset" type="int64">
  Смещение от начала.
</ParamField>

<ParamField body="status" type="string">
  Фильтр по **внутреннему** статусу (`pending`, `approved`, `broadcasting`, `sent`, `confirmed`, `failed`, `cancelled`, `awaiting_cosign`) — **не** по укрупнённому `check`/`process`/`paid`. Пусто = все. См. [статусы выплаты](/reference/payout-object#статусы-выплаты).
</ParamField>

<Note>
  **Фильтр `status` принимает внутренние статусы, а не укрупнённые.** В ответе вы видите
  укрупнённый статус (например `paid`), но чтобы отобрать такие записи, фильтруйте по
  внутреннему `confirmed`. Соответствие — в таблице ниже.
</Note>

| Укрупнённый (в ответе)             | Внутренний (для фильтра `status`)  |
| ---------------------------------- | ---------------------------------- |
| `check`                            | `pending`                          |
| `process`                          | `approved`, `broadcasting`, `sent` |
| `paid`                             | `confirmed`                        |
| `fail`                             | `failed`                           |
| `cancel`                           | `cancelled`                        |
| `awaiting_cosign` (без укрупнения) | `awaiting_cosign`                  |

***

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

<CodeGroup>
  ```bash cURL theme={null}
  BODY='{"limit":25,"offset":0}'
  TS=$(date +%s)
  SIG=$(printf '%s\n%s\n%s\n%s' "$TS" 'POST' '/v1/payout/history' "$BODY" \
    | openssl dgst -sha256 -hmac "$SECRET" -hex | sed 's/^.* //')
  curl -s https://api.oblodai.com/v1/payout/history \
    -X POST -H 'Content-Type: application/json' \
    -H "X-Public-Id: $PUBLIC_ID" -H "X-Timestamp: $TS" -H "X-Signature: $SIG" \
    -d "$BODY"
  ```

  ```python Python theme={null}
  call("/v1/payout/history", {"limit": 25, "offset": 0})
  ```

  ```js Node.js theme={null}
  await call("/v1/payout/history", { limit: 25, offset: 0 });
  ```
</CodeGroup>

***

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

```json theme={null}
{
  "state": 0,
  "result": {
    "items": [
      { "uuid": "0c1f...e9", "order_id": "payout-1", "amount": "25",
        "currency": "USDT", "status": "paid", "is_final": true }
    ],
    "paginate": { "count": 42, "per_page": 25, "offset": 0 }
  }
}
```

`paginate.count` — общее число записей по фильтру, не размер страницы.

***

## Связанные страницы

<CardGroup cols={2}>
  <Card title="Объект выплаты" href="/reference/payout-object" icon="arrow-right" horizontal />

  <Card title="POST /v1/payout/info" href="/reference/payout-info" icon="arrow-right" horizontal />
</CardGroup>