> ## Documentation Index
> Fetch the complete documentation index at: https://docs.upaybr.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Listar antecipações

> Consulte o histórico de solicitações de antecipação

## Listar antecipações

```
GET /api/advances/
```

**Autenticação**: Bearer Token (JWT)

### Parâmetros de query

| Parâmetro | Tipo      | Padrão | Descrição                     |
| --------- | --------- | ------ | ----------------------------- |
| `page`    | `integer` | `1`    | Página da listagem            |
| `limit`   | `integer` | `20`   | Itens por página (máximo 100) |

### Exemplo

```bash theme={null}
curl --request GET \
  --url 'https://upay-sistema-api.onrender.com/api/advances/?page=1&limit=20' \
  --header 'Authorization: Bearer SEU_JWT_TOKEN'
```

### Resposta (`200 OK`)

```json theme={null}
{
  "success": true,
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "amountCents": 50000,
      "netAmountCents": 48500,
      "feeCents": 1500,
      "status": "COMPLETED",
      "createdAt": "2026-05-25T00:00:00.000Z",
      "completedAt": "2026-05-26T00:00:00.000Z"
    }
  ],
  "meta": {
    "page": 1,
    "limit": 20,
    "total": 3,
    "totalPages": 1
  }
}
```

***

## Obter antecipação específica

```
GET /api/advances/:id
```

### Exemplo

```bash theme={null}
curl --request GET \
  --url https://upay-sistema-api.onrender.com/api/advances/550e8400-e29b-41d4-a716-446655440000 \
  --header 'Authorization: Bearer SEU_JWT_TOKEN'
```

### Resposta (`200 OK`)

```json theme={null}
{
  "success": true,
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "amountCents": 50000,
    "netAmountCents": 48500,
    "feeCents": 1500,
    "feePercentage": 3.0,
    "status": "COMPLETED",
    "reason": "Capital de giro",
    "createdAt": "2026-05-25T00:00:00.000Z",
    "completedAt": "2026-05-26T00:00:00.000Z"
  }
}
```

<Card title="Solicitar antecipação" icon="plus" href="./create" horizontal>
  Crie uma nova solicitação de antecipação.
</Card>