---
title: "GET /refunds"
method: GET
path: "/refunds"
tags: ["Возвраты"]
---

# GET /refunds

`GET /refunds`

Список возвратов

## 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
- `payment_id` string
- `status` 'pending' | 'succeeded' | 'canceled'
- `limit` integer
- `cursor` string

## Response `200`

The request has succeeded.

- RefundList
  - `type` string, required
  - `items` Refund[], required
    - `id` string, required
    - `payment_id` string, required
    - `status` 'pending' | 'succeeded' | 'canceled', required
    - `cancellation_details` RefundCancellationDetails
      - `party` string, required
      - `reason` string, required
    - `receipt_registration` 'pending' | 'succeeded' | 'canceled'
    - `created_at` string, date-time, required — Время создания возврата.
    - `amount` MonetaryAmount, required
      - `value` string, required — Сумма в выбранной валюте. Выражается в виде строки и пишется через точку, например 10.00.
      - `currency` 'RUB' | 'EUR' | 'USD' | 'KZT' | 'BYN' | 'UAH' | 'UZS' | 'TRY' | 'INR' | 'MDL' | 'AZN' | 'AMD', required
    - `description` string
    - `sources` RefundSourcesData[] — Источники средств для возврата.
      - `account_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
      - `platform_fee_amount` MonetaryAmount
        - `value` string, required — Сумма в выбранной валюте. Выражается в виде строки и пишется через точку, например 10.00.
        - `currency` 'RUB' | 'EUR' | 'USD' | 'KZT' | 'BYN' | 'UAH' | 'UZS' | 'TRY' | 'INR' | 'MDL' | 'AZN' | 'AMD', required
    - `deal` RefundDealInfo
      - `id` string, required
      - `refund_settlements` SettlementRefundItem[], required — Данные о распределении денег.
        - `type` 'payout', required
        - `amount` MonetaryAmount, required
          - `value` string, required — Сумма в выбранной валюте. Выражается в виде строки и пишется через точку, например 10.00.
          - `currency` 'RUB' | 'EUR' | 'USD' | 'KZT' | 'BYN' | 'UAH' | 'UZS' | 'TRY' | 'INR' | 'MDL' | 'AZN' | 'AMD', required
    - `refund_method` union — Способ возврата.
      - SbpRefundMethod
        - `type` 'sbp' | 'electronic_certificate', required
      - ElectronicCertificateRefundMethod
        - `type` 'sbp' | 'electronic_certificate', required
    - `refund_authorization_details` RefundAuthorizationDetails
      - `rrn` string
    - `metadata` Metadata — Любые дополнительные данные, которые нужны вам для работы (например, номер заказа). Передаются в виде набора пар «ключ-значение» и возвращаются в ответе от ЮKassa. Ограничения: максимум 16 ключей, имя ключа не больше 32 символов, значение ключа не больше 512 символов, тип данных — строка в формате UTF-8.
  - `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.
- `500` — Server error

## Changes

- **2026-02-14** `fe24d3dfadad` — 20 breaking, 1 warning, 68 info
  - for the `query` request parameter `limit`, the type/format was changed from `integer`/`` to `integer`/`int32`
  - the `items/items/description` response property's maxLength was unset from `250` for the response status `200`
  - the `items/items/id` response property's maxLength was unset from `36` for the response status `200`
  - the `items/items/payment_id` response property's maxLength was unset from `36` for the response status `200`
  - …85 more

[Change history](https://skmtc.dev/hexlet/apis/api-kassa/changes/refunds/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)