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

# Obter Histórico de Recarga Automática

> Listar eventos recentes de recarga automática

# Obter Histórico de Recarga Automática

Lista os eventos recentes de recarga automática do seu ambiente, incluindo valor, status e o disparador (limite mínimo ou agendado).

## Endpoint

```
GET /api/v1/auto-topup/history
```

## Parâmetros de consulta

<ParamField query="per_page" type="integer">Itens por página. Faixa: `1`–`100`. Padrão: `25`.</ParamField>
<ParamField query="page" type="integer">Número da página. Padrão: `1`.</ParamField>

## Cabeçalhos da requisição

<ParamField header="Authorization" type="string" required>
  Token Bearer para autenticação. Formato: `Bearer talq_your_environment_token_here`
</ParamField>

## Exemplos

<RequestExample>
  ```bash theme={null}
  curl "https://app.talkover.ai/api/v1/auto-topup/history?per_page=10" \
    -H "Authorization: Bearer talq_your_environment_token_here"
  ```
</RequestExample>

## Resposta

<ResponseExample>
  ```json theme={null}
  {
    "success": true,
    "data": [
      {
        "id": "topup-uuid-1",
        "amount": 100.00,
        "currency": "USD",
        "trigger": "threshold",
        "status": "succeeded",
        "balance_before": 42.00,
        "balance_after": 142.00,
        "payment_method_id": "pm_uuid_1",
        "transaction_id": "txn_uuid_1",
        "created_at": "2024-01-10T14:30:00Z"
      },
      {
        "id": "topup-uuid-2",
        "amount": 200.00,
        "currency": "USD",
        "trigger": "scheduled",
        "status": "failed",
        "failure_reason": "card_declined",
        "payment_method_id": "pm_uuid_1",
        "created_at": "2024-01-01T08:00:00Z"
      }
    ],
    "pagination": {
      "current_page": 1,
      "per_page": 10,
      "total": 23,
      "last_page": 3
    }
  }
  ```
</ResponseExample>

### Valores de Disparador

* `threshold` — disparado porque o saldo caiu abaixo de `threshold_amount`
* `scheduled` — disparado em um dia configurado do mês
* `test` — recarga de teste manual via [Testar Recarga Automática](/api-reference/endpoints/test-auto-topup)

### Valores de Status

* `pending` — pagamento em processamento
* `succeeded` — pagamento capturado, saldo creditado
* `failed` — pagamento recusado ou com erro