---
title: "GET /payouts"
method: GET
path: "/payouts"
tags: ["Выплаты"]
---

# GET /payouts

`GET /payouts`

Список выплат

## Query parameters

- `created_at.gte` string, date-time
- `created_at.gt` string, date-time
- `created_at.lte` string, date-time
- `created_at.lt` string, date-time
- `payout_destination.type` 'bank_card' | 'yoo_money' | 'sbp'
- `status` 'pending' | 'succeeded' | 'canceled'
- `limit` integer
- `cursor` string

## Response `200`

The request has succeeded.

- PayoutsList
  - `type` string, required — Тип списка.
  - `items` Payout[], required — Список выплат.
    - `id` string, required
    - `amount` MonetaryAmount, required
      - `value` string, required — Сумма в выбранной валюте. Выражается в виде строки и пишется через точку, например 10.00.
      - `currency` 'RUB' | 'EUR' | 'USD' | 'KZT' | 'BYN' | 'UAH' | 'UZS' | 'TRY' | 'INR' | 'MDL' | 'AZN' | 'AMD', required
    - `status` 'pending' | 'succeeded' | 'canceled', required
    - `payout_destination` union, required — Данные о назначении выплаты.
      - PayoutToCardDestination
        - `type` 'bank_card' | 'yoo_money' | 'sbp', required
      - PayoutToYooMoneyDestination
        - `type` 'bank_card' | 'yoo_money' | 'sbp', required
      - PayoutToSbpDestination
        - `type` 'bank_card' | 'yoo_money' | 'sbp', required
    - `description` string
    - `created_at` string, date-time, required — Время создания выплаты.
    - `succeeded_at` string, date-time — Время проведения выплаты.
    - `deal` PayoutDealInfo
      - `id` string, required
    - `self_employed` PayoutSelfEmployedInfo
      - `id` string, required
    - `receipt` IncomeReceipt
      - `service_name` string, required
      - `npd_receipt_id` string
      - `url` string
      - `amount` MonetaryAmount
        - `value` string, required — Сумма в выбранной валюте. Выражается в виде строки и пишется через точку, например 10.00.
        - `currency` 'RUB' | 'EUR' | 'USD' | 'KZT' | 'BYN' | 'UAH' | 'UZS' | 'TRY' | 'INR' | 'MDL' | 'AZN' | 'AMD', required
    - `cancellation_details` PayoutCancellationDetails
      - `party` string, required
      - `reason` string, required
    - `metadata` Metadata — Любые дополнительные данные, которые нужны вам для работы (например, номер заказа). Передаются в виде набора пар «ключ-значение» и возвращаются в ответе от ЮKassa. Ограничения: максимум 16 ключей, имя ключа не больше 32 символов, значение ключа не больше 512 символов, тип данных — строка в формате UTF-8.
    - `test` boolean, required — Признак тестовой операции.
  - `next_cursor` string

## Other responses

- `400` — The server could not understand the request due to invalid syntax.
- `401` — Access is unauthorized.
- `403` — Access is forbidden.
- `404` — The server cannot find the requested resource.
- `429` — Client error
- `500` — Server error

## Changes

- **2026-02-14** `fe24d3dfadad` — 18 breaking, 3 warning, 43 info
  - for the `query` request parameter `limit`, the type/format was changed from `integer`/`` to `integer`/`int32`
  - the `items/items/deal/allOf[#/components/schemas/PayoutDealInfo]/id` response property's maxLength was unset from `50` for the response status `200`
  - the `items/items/description/allOf[#/components/schemas/Description]/` response property's maxLength was unset from `128` for the response status `200`
  - the `items/items/id` response property's maxLength was unset from `50` for the response status `200`
  - …60 more

[Change history](https://skmtc.dev/hexlet/apis/api-kassa/changes/payouts/get.md)

---

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