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

# Listar tentativas de cadastro

> Lista o histórico de confirmações de um cadastro de cartão.

Lista as tentativas de um único `setup_intent`, da mais recente para a mais
antiga. Esta operação é server-side e exige uma chave secreta com escopo de
leitura.

<ParamField query="setup_intent" type="string" required>
  Cadastro (`seti_*`) cujo histórico será consultado.
</ParamField>

<ParamField query="limit" type="number" default="10">
  Quantidade de itens por página, de `1` a `100`.
</ParamField>

<ParamField query="starting_after" type="string">
  Retorna itens depois do `setatt_*` informado.
</ParamField>

<ParamField query="ending_before" type="string">
  Retorna itens antes do `setatt_*` informado.
</ParamField>

<RequestExample>
  ```bash cURL theme={"theme":"css-variables"}
  curl -X GET "https://api.chargefy.io/v1/setup-attempts?setup_intent=seti_VsaygQA79ZNhy4CQ" \
    -H "Authorization: Bearer {{API_KEY}}"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={"theme":"css-variables"}
  {
    "object": "list",
    "data": [
      {
        "id": "setatt_L6ZmE4rSCaYzP5wJ",
        "object": "setup_attempt",
        "created_at": "2026-08-07T12:01:00Z",
        "customer": "cus_AAMdwCYQ7FEPFrBX",
        "livemode": false,
        "payment_method": "pm_Be2jZhX6ifbAAP46",
        "payment_method_details": {
          "credit_card": {
            "brand": "visa",
            "exp_month": 12,
            "exp_year": 2030,
            "last4": "4242"
          },
          "type": "credit_card"
        },
        "setup_error": null,
        "setup_intent": "seti_VsaygQA79ZNhy4CQ",
        "status": "succeeded",
        "usage": "off_session"
      }
    ],
    "has_more": false,
    "url": "/v1/setup-attempts?setup_intent=seti_VsaygQA79ZNhy4CQ"
  }
  ```
</ResponseExample>

## Erros

| Situação                                                | HTTP  | `code`                                      |
| ------------------------------------------------------- | ----- | ------------------------------------------- |
| `setup_intent` ausente                                  | `400` | `invalid_request` com `param: setup_intent` |
| Cadastro não existe, é de outra organização ou ambiente | `404` | `resource_missing`                          |
| Chave ausente ou inválida                               | `401` | `authentication_failed`                     |
| Chave sem leitura                                       | `403` | `permission_denied`                         |