---
title: "Retornando pagamentos por recebedor"
url: "https://devcenter.stone.com.br/apis/v5-docs-legacy/versions/b9aaff36-6dcc-4353-8398-836d6c13dfa5/operations/retornando-pagamentos-por-recebedor"
---

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

# Retornando pagamentos por recebedor

`GET` `/recipients/{recipient_id}/settlements`

Operation ID: `retornando-pagamentos-por-recebedor`

Retorna um Array contendo objetos de pagamentos (settlements) de um recebedor ordenados a partir da data de criação colocando os mais recentes no topo.

## Path parameters

- `recipient_id` (string, required) - ID do recebedor

## Query parameters

- `payment_date_start` (string, required) - Início da data de pagamento (inclusivo). Data no formato YYYY-MM-DD
- `payment_date_end` (string, required) - Fim da data de pagamento (inclusivo). Data no formato YYYY-MM-DD

## 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}/settlements:
    get:
      summary: Retornando pagamentos por recebedor
      description: Retorna um Array contendo objetos de pagamentos (settlements) de um
        recebedor ordenados a partir da data de criação colocando os mais
        recentes no topo.
      operationId: retornando-pagamentos-por-recebedor
      parameters:
        - name: recipient_id
          in: path
          description: ID do recebedor
          schema:
            type: string
          required: true
        - name: payment_date_start
          in: query
          description: Início da data de pagamento (inclusivo). Data no formato YYYY-MM-DD
          required: true
          schema:
            type: string
        - name: payment_date_end
          in: query
          description: Fim da data de pagamento (inclusivo). Data no formato YYYY-MM-DD
          required: true
          schema:
            type: string
      responses:
        "200":
          description: "200"
          content:
            application/json:
              examples:
                Result:
                  value: "{}"
              schema:
                type: object
                properties: {}
        "400":
          description: "400"
          content:
            application/json:
              examples:
                Result:
                  value: "{}"
              schema:
                type: object
                properties: {}
      deprecated: false
security:
  - sec0: []
components:
  securitySchemes:
    sec0:
      type: http
      scheme: basic
```