---
title: "Listar saques"
url: "https://devcenter.stone.com.br/apis/v5-docs-legacy/versions/b9aaff36-6dcc-4353-8398-836d6c13dfa5/operations/listar-saques-1"
---

> Full API specification: https://devcenter.stone.com.br/apis/v5-docs-legacy/versions/b9aaff36-6dcc-4353-8398-836d6c13dfa5.md

# Listar saques

`GET` `/recipients/{recipient_id}/withdrawals`

Operation ID: `listar-saques-1`

Rota para realizar a consulta de saques para um determinado **recebedor**.

## Path parameters

- `recipient_id` (string, required) - Código do recebedor

## Query parameters

- `status` (string, optional) - Filtro para o status da transferência
- `created_since` (string, date, optional) - Filtro para início do range da data de criação da transferência
- `created_until` (string, date, optional) - Filtro para o fim do range da data de criação da transferência

## Responses

- `200` - 200
- `400` - 400

## OpenAPI definition

```yaml
openapi: 3.1.0
info:
  title: Pagar.me v5 API (Legado)
  version: 5.0.0
servers:
  - url: https://api.stone.com.br/core/v5
paths:
  /recipients/{recipient_id}/withdrawals:
    get:
      summary: Listar saques
      description: Rota para realizar  a consulta de saques para um determinado
        **recebedor**.
      operationId: listar-saques-1
      parameters:
        - name: recipient_id
          in: path
          description: Código do recebedor
          schema:
            type: string
          required: true
        - name: status
          in: query
          description: Filtro para o status da transferência
          schema:
            type: string
        - name: created_since
          in: query
          description: Filtro para início do range da data de criação da transferência
          schema:
            type: string
            format: date
        - name: created_until
          in: query
          description: Filtro para o fim do range da data de criação da transferência
          schema:
            type: string
            format: date
      responses:
        "200":
          description: "200"
          content:
            application/json:
              examples:
                Result:
                  value: |-
                    [
                        {
                          "id": "with_dADVpgxcmT0v5voP",
                          "amount": 100,
                          "status": "failed",
                          "created_at": "2020-01-16T17:04:33Z",
                          "updated_at": "2020-01-16T17:04:33Z",
                          "bank_account": {
                            "id": "ba_jGXwbQtNASZZrdpE",
                            "holder_name": "Second recipient",
                            "holder_type": "company",
                            "holder_document": "15313587000166",
                            "bank": "341",
                            "branch_number": "12345",
                            "branch_check_digit": "6",
                            "account_number": "12345",
                            "account_check_digit": "6",
                            "type": "checking",
                            "status": "active",
                            "created_at": "2020-01-02T20:23:17Z",
                            "updated_at": "2020-01-02T20:23:17Z",
                            "metadata": {
                              "meta_key": "meta_value"
                            },
                            "recipient": {
                              "id": "rp_yLnAyVpHbQIqZxwO",
                              "name": "Second recipient",
                              "email": "second_recipient@pagar.me",
                              "document": "15313587000166",
                              "description": "Descrição do recebedor 2",
                              "type": "company",
                              "status": "active",
                              "created_at": "2020-01-02T20:23:17Z",
                              "updated_at": "2020-01-02T20:23:17Z"
                            }
                          }
                        },
                        {
                          "id": "with_rax8WlIjeHXxwe6z",
                          "amount": 100,
                          "status": "failed",
                          "created_at": "2020-01-16T17:04:23Z",
                          "updated_at": "2020-01-16T17:04:23Z",
                          "bank_account": {
                            "id": "ba_jGXwbQtNASZZrdpE",
                            "holder_name": "Second recipient",
                            "holder_type": "company",
                            "holder_document": "15313587000166",
                            "bank": "341",
                            "branch_number": "12345",
                            "branch_check_digit": "6",
                            "account_number": "12345",
                            "account_check_digit": "6",
                            "type": "checking",
                            "status": "active",
                            "created_at": "2020-01-02T20:23:17Z",
                            "updated_at": "2020-01-02T20:23:17Z",
                            "metadata": {
                              "meta_key": "meta_value"
                            },
                            "recipient": {
                              "id": "rp_yLnAyVpHbQIqZxwO",
                              "name": "Second recipient",
                              "email": "second_recipient@pagar.me",
                              "document": "15313587000166",
                              "description": "Descrição do recebedor 2",
                              "type": "company",
                              "status": "active",
                              "created_at": "2020-01-02T20:23:17Z",
                              "updated_at": "2020-01-02T20:23:17Z"
                            }
                          }
                        }
                    ]
        "400":
          description: "400"
          content:
            application/json:
              examples:
                Result:
                  value: "{}"
              schema:
                type: object
                properties: {}
      deprecated: false
security:
  - sec0: []
components:
  securitySchemes:
    sec0:
      type: http
      scheme: basic
```
