> ## 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.

# List Payment Intents

> Lista payment intents.

Lista `payment_intents` em ordem decrescente de criação.

## Filtros

<ParamField query="customer" type="string">
  Filtra por customer (`cus_*`).
</ParamField>

<ParamField query="invoice" type="string">
  Filtra por invoice (`inv_*`).
</ParamField>

<ParamField query="status" type="string">
  Filtra por status.
</ParamField>

<ParamField query="limit" type="integer">
  Quantidade de itens, de `1` a `100`.
</ParamField>

<ParamField query="starting_after" type="string">
  Cursor para a próxima página.
</ParamField>

<ParamField query="ending_before" type="string">
  Cursor para a página anterior.
</ParamField>

<ParamField query="expand[]" type="string">
  Use `payment_method` para expandir métodos salvos ou `latest_charge` para
  expandir a última tentativa de cobrança.
</ParamField>

<RequestExample>
  ```bash cURL theme={}
  curl -X GET "https://api.chargefy.io/v1/payment-intents?customer=cus_123&limit=10" \
    -H "Authorization: Bearer {{API_KEY}}"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={}
  {
    "object": "list",
    "data": [
      {
        "id": "pi_123",
        "object": "payment_intent",
        "amount": 10528,
        "amount_capturable": 0,
        "amount_details": {
          "installment_interest": 528,
          "subtotal": 10000,
          "total": 10528
        },
        "amount_received": 10528,
        "canceled_at": null,
        "cancellation_reason": null,
        "capture_method": "automatic",
        "client_secret": "pi_123_secret_abc",
        "confirmation_method": "automatic",
        "created_at": "2026-05-16T18:34:58Z",
        "currency": "brl",
        "customer": "cus_123",
        "invoice": "inv_123",
        "last_payment_error": null,
        "latest_charge": "ch_123",
        "livemode": true,
        "metadata": {},
        "next_action": null,
        "payment_method": "pm_123",
        "payment_method_options": {
          "credit_card": {
            "installments": {
              "amount_subtotal": 10000,
              "amount_total": 10528,
              "count": 3,
              "has_interest": true,
              "interest_amount": 528
            }
          }
        },
        "payment_method_types": [
          "credit_card"
        ],
        "setup_future_usage": null,
        "status": "succeeded",
        "updated_at": "2026-05-16T18:35:00Z"
      }
    ],
    "has_more": false,
    "url": "/v1/payment-intents"
  }
  ```

  ```json 400 theme={}
  {
    "error": {
      "code": "invalid_request",
      "message": "limit must be between 1 and 100.",
      "param": "limit",
      "type": "invalid_request_error"
    }
  }
  ```

  ```json 401 theme={}
  {
    "error": {
      "code": "authentication_failed",
      "message": "Invalid API key provided.",
      "type": "authentication_error"
    }
  }
  ```
</ResponseExample>