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

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

# Listar recebedores

`GET` `/recipients`

Operation ID: `listar-recebedores-1`

Retorna uma lista de objetos com os dados dos recebedor encontrados.

## Query parameters

- `page` (integer, int32, optional) - Página atual.
- `size` (integer, int32, optional) - Quantidade de itens por página.

## 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:
    get:
      summary: Listar recebedores
      description: Retorna uma lista de objetos com os dados dos recebedor encontrados.
      operationId: listar-recebedores-1
      parameters:
        - name: page
          in: query
          description: Página atual.
          schema:
            type: integer
            format: int32
            default: 1
        - name: size
          in: query
          description: Quantidade de itens por página.
          schema:
            type: integer
            format: int32
            default: 10
      responses:
        "200":
          description: "200"
          content:
            application/json:
              examples:
                Result:
                  value: |-
                    {
                        "data": [
                            {
                                "id": "rp_Gxb5NJNiqvf0Y5Xv",
                                "name": "Tony Stark",
                                "email": "tstark@avengers.com",
                                "document": "26224451990",
                                "description": "Recebedor Tony Stark",
                                "type": "individual",
                                "status": "active",
                                "created_at": "2017-10-27T16:12:37Z",
                                "updated_at": "2017-10-27T16:12:37Z",
                                "transfer_settings": {
                                    "transfer_enabled": false,
                                    "transfer_interval": "Daily",
                                    "transfer_day": 0
                                 },
                                "default_bank_account": {
                                    "id": "ba_KOoYDmEHvIEYD6v3",
                                    "holder_name": "Tony Stark",
                                    "holder_type": "individual",
                                    "holder_document": "26224451990",
                                    "bank": "341",
                                    "branch_number": "12345",
                                    "branch_check_digit": "6",
                                    "account_number": "12345",
                                    "account_check_digit": "6",
                                    "type": "checking",
                                    "status": "active",
                                    "created_at": "2017-10-27T19:03:21Z",
                                    "updated_at": "2017-10-27T19:03:21Z",
                                    "metadata": {
                                        "meta_key": "meta_value"
                                    }
                                },
                                "metadata": {
                                    "key": "value"
                                }
                            }
                        ],
                        "paging": {
                            "total": 1
                        }
                    }
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          example: rp_Gxb5NJNiqvf0Y5Xv
                        name:
                          type: string
                          example: Tony Stark
                        email:
                          type: string
                          example: tstark@avengers.com
                        document:
                          type: string
                          example: "26224451990"
                        description:
                          type: string
                          example: Recebedor Tony Stark
                        type:
                          type: string
                          example: individual
                        status:
                          type: string
                          example: active
                        created_at:
                          type: string
                          example: 2017-10-27T16:12:37Z
                        updated_at:
                          type: string
                          example: 2017-10-27T16:12:37Z
                        transfer_settings:
                          type: object
                          properties:
                            transfer_enabled:
                              type: boolean
                              example: false
                              default: true
                            transfer_interval:
                              type: string
                              example: Daily
                            transfer_day:
                              type: integer
                              example: 0
                              default: 0
                        default_bank_account:
                          type: object
                          properties:
                            id:
                              type: string
                              example: ba_KOoYDmEHvIEYD6v3
                            holder_name:
                              type: string
                              example: Tony Stark
                            holder_type:
                              type: string
                              example: individual
                            holder_document:
                              type: string
                              example: "26224451990"
                            bank:
                              type: string
                              example: "341"
                            branch_number:
                              type: string
                              example: "12345"
                            branch_check_digit:
                              type: string
                              example: "6"
                            account_number:
                              type: string
                              example: "12345"
                            account_check_digit:
                              type: string
                              example: "6"
                            type:
                              type: string
                              example: checking
                            status:
                              type: string
                              example: active
                            created_at:
                              type: string
                              example: 2017-10-27T19:03:21Z
                            updated_at:
                              type: string
                              example: 2017-10-27T19:03:21Z
                            metadata:
                              type: object
                              properties:
                                meta_key:
                                  type: string
                                  example: meta_value
                        metadata:
                          type: object
                          properties:
                            key:
                              type: string
                              example: value
                  paging:
                    type: object
                    properties:
                      total:
                        type: integer
                        example: 1
                        default: 0
        "400":
          description: "400"
          content:
            application/json:
              examples:
                Result:
                  value: "{}"
              schema:
                type: object
                properties: {}
      deprecated: false
security:
  - sec0: []
components:
  securitySchemes:
    sec0:
      type: http
      scheme: basic
```