---
updatedAt: 2026-04-06T17:32:56.000Z
agentTools:
  projectIndex: https://docs.pagar.me/v4/llms.txt
---

# 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.

> ❗️ Atenção: Essa versão de API será descontinuada
>
> Essa versão da API Pagar.me já não é mais atualizada e, em breve, deixará de funcionar. Para que sua loja possa vender sem problemas, você precisa realizar sua integração usando a versão mais recente da nossa API, a V5.
>
> No canto superior esquerdo da tela é indicado qual versão da documentação você está vendo. Clique na seta onde indica a versão e altere para a V5 para acessar a documentação.
>
> Se você já é cliente, precisa realizar obrigatoriamente a migração para a versão V5.
>
> Em caso de dúvidas, basta entrar em contato com o nosso time de atendimento através do e-mail, enviando a sua dúvida para <relacionamento@pagar.me> e por telefone, ligando para 4004-1330. Se você já é cliente pode também entrar em contato através do chat dentro da sua Dashboard.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "api-settings",
    "version": "4"
  },
  "servers": [
    {
      "url": "https://api.pagar.me/1"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "x-default": "",
        "type": "apiKey",
        "name": "api_key",
        "in": "query"
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "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)",
            "schema": {
              "type": "string",
              "format": "date"
            }
          },
          {
            "name": "payment_date_end",
            "in": "query",
            "description": "Fim da data de pagamento (inclusivo)",
            "schema": {
              "type": "string",
              "format": "date"
            }
          },
          {
            "name": "liquidation_arrangement_id",
            "in": "query",
            "description": "ID da LiquidationArrangement",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n  \"settlements\": [\n    {\n      \"id\": \"sett_abc1d23e45fgh6ijkl78901mn\",\n      \"status\": \"success\",\n      \"amount\": \"10000\",\n      \"product\": \"credit\",\n      \"card_brand\": \"elo\",\n      \"company_id\": \"5556ab7c8d7efghi901jk23l4\",\n      \"payment_date\": \"2021-04-07\",\n      \"recipient_id\": \"re_abcd12e3f45ghi67jkl8m9nop\",      \n      \"document_type\": \"cnpj\",\n      \"document_number\": \"12345678000121\",\n      \"liquidation_type\": \"internal\",\n      \"contract_obligation_id\": null,\n      \"liquidation_arrangement_id\": \"la_abc1defgh234i5jklmnopq678\",\n      \"contract_key\": \"84cb8802-9f33-4b34-bbc1-da1610fe05df\"\n\t\t}\n  ]\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "settlements": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string",
                            "example": "sett_abc1d23e45fgh6ijkl78901mn"
                          },
                          "status": {
                            "type": "string",
                            "example": "success"
                          },
                          "amount": {
                            "type": "string",
                            "example": "10000"
                          },
                          "product": {
                            "type": "string",
                            "example": "credit"
                          },
                          "card_brand": {
                            "type": "string",
                            "example": "elo"
                          },
                          "company_id": {
                            "type": "string",
                            "example": "5556ab7c8d7efghi901jk23l4"
                          },
                          "payment_date": {
                            "type": "string",
                            "example": "2021-04-07"
                          },
                          "recipient_id": {
                            "type": "string",
                            "example": "re_abcd12e3f45ghi67jkl8m9nop"
                          },
                          "document_type": {
                            "type": "string",
                            "example": "cnpj"
                          },
                          "document_number": {
                            "type": "string",
                            "example": "12345678000121"
                          },
                          "liquidation_type": {
                            "type": "string",
                            "example": "internal"
                          },
                          "contract_obligation_id": {},
                          "liquidation_arrangement_id": {
                            "type": "string",
                            "example": "la_abc1defgh234i5jklmnopq678"
                          },
                          "contract_key": {
                            "type": "string",
                            "example": "84cb8802-9f33-4b34-bbc1-da1610fe05df"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "400",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {}
                }
              }
            }
          }
        },
        "deprecated": false,
        "x-readme": {
          "code-samples": [
            {
              "language": "curl",
              "code": "curl -X GET https://api.pagar.me/1/recipients/ID_DO_RECEBEDOR/settlements -H 'content-type: application/json' -d '{\n    \"api_key\": \"ak_test_grXijQ4GicOa2BLGZrDRTR5qNQxJW0\"\n}'"
            }
          ],
          "samples-languages": [
            "curl"
          ]
        }
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```