---
updatedAt: 2026-04-06T17:53:38.000Z
agentTools:
  projectIndex: https://docs.pagar.me/llms.txt
---

# Retornando antecipações

Retorna uma lista contendo objetos de antecipações.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "pagarme-api",
    "version": "5"
  },
  "servers": [
    {
      "url": "https://api.pagar.me/core/v5"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "http",
        "scheme": "basic"
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/recipients/{recipient_id}/bulk_anticipations": {
      "get": {
        "summary": "Retornando antecipações",
        "description": "Retorna uma lista contendo objetos de antecipações.",
        "operationId": "retornando-antecipações",
        "parameters": [
          {
            "name": "recipient_id",
            "in": "path",
            "schema": {
              "type": "string"
            },
            "required": true
          },
          {
            "name": "count",
            "in": "query",
            "description": "Retorna n resultados, com um máximo de 1000",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "description": "Útil para implementação de uma paginação de resultados",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "amount",
            "in": "query",
            "description": "Filtro de amount",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "fee",
            "in": "query",
            "description": "Filtro de fee",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "anticipation_fee",
            "in": "query",
            "description": "Filtro de anticipation fee",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "id",
            "in": "query",
            "description": "ID da antecipação procurada",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "payment_date",
            "in": "query",
            "description": "Data de pagamento procurada",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "[\n  {\n    \"id\": \"ba_123456789\",\n    \"status\": \"approved\",\n    \"amount\": 100000,\n    \"fee\": 5000,\n    \"fraud_coverage_fee\": 0,\n    \"anticipation_fee\": 3000,\n    \"automatic_transfer\": false,\n    \"type\": \"spot\",\n    \"timeframe\": \"start\",\n    \"payment_date\": \"2025-08-20T00:00:00.000Z\",\n    \"created_at\": \"2025-08-19T14:23:00.000Z\",\n    \"updated_at\": \"2025-08-20T10:15:00.000Z\",\n    \"anticipation_tax\": null\n  },\n  {\n    \"id\": \"ba_987654321\",\n    \"status\": \"canceled\",\n    \"amount\": 50000,\n    \"fee\": 2500,\n    \"fraud_coverage_fee\": 0,\n    \"anticipation_fee\": 1500,\n    \"automatic_transfer\": true,\n    \"type\": \"spot\",\n    \"timeframe\": \"end\",\n    \"payment_date\": \"2025-08-18T00:00:00.000Z\",\n    \"created_at\": \"2025-08-17T09:00:00.000Z\",\n    \"updated_at\": \"2025-08-18T10:00:00.000Z\",\n    \"anticipation_tax\": 0.015\n  }\n]"
                  }
                },
                "schema": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "id": {
                        "type": "string",
                        "example": "ba_123456789"
                      },
                      "status": {
                        "type": "string",
                        "example": "approved"
                      },
                      "amount": {
                        "type": "integer",
                        "example": 100000,
                        "default": 0
                      },
                      "fee": {
                        "type": "integer",
                        "example": 5000,
                        "default": 0
                      },
                      "fraud_coverage_fee": {
                        "type": "integer",
                        "example": 0,
                        "default": 0
                      },
                      "anticipation_fee": {
                        "type": "integer",
                        "example": 3000,
                        "default": 0
                      },
                      "automatic_transfer": {
                        "type": "boolean",
                        "example": false,
                        "default": true
                      },
                      "type": {
                        "type": "string",
                        "example": "spot"
                      },
                      "timeframe": {
                        "type": "string",
                        "example": "start"
                      },
                      "payment_date": {
                        "type": "string",
                        "example": "2025-08-20T00:00:00.000Z"
                      },
                      "created_at": {
                        "type": "string",
                        "example": "2025-08-19T14:23:00.000Z"
                      },
                      "updated_at": {
                        "type": "string",
                        "example": "2025-08-20T10:15:00.000Z"
                      },
                      "anticipation_tax": {}
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "400",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{ \"errors\": [{ \"type\": \"invalid_parameter_error\", \"parameter_name\": \"page\", \"message\": \"Página inválida.\" }] }"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "errors": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "type": {
                            "type": "string",
                            "example": "invalid_parameter_error"
                          },
                          "parameter_name": {
                            "type": "string",
                            "example": "page"
                          },
                          "message": {
                            "type": "string",
                            "example": "Página inválida."
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```