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

> Lista payment methods.

Lista métodos salvos de um customer. Nesta primeira versão, `customer` é
obrigatório para manter o contexto de ownership explícito.

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

<ParamField query="type" type="string">
  Hoje aceita apenas `credit_card`.
</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>

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

<ResponseExample>
  ```json 200 theme={}
  {
    "object": "list",
    "data": [
      {
        "id": "pm_123",
        "object": "payment_method",
        "billing_details": {
          "address": null,
          "email": "cliente@email.com",
          "name": "Ana Silva",
          "phone": null
        },
        "card": {
          "brand": "visa",
          "exp_month": 12,
          "exp_year": 2030,
          "last4": "4242"
        },
        "created_at": "2026-05-16T18:30:00Z",
        "customer": "cus_123",
        "livemode": true,
        "metadata": {},
        "type": "credit_card",
        "updated_at": "2026-05-16T18:30:00Z"
      }
    ],
    "has_more": false,
    "url": "/v1/payment-methods"
  }
  ```

  ```json 400 theme={}
  {
    "error": {
      "code": "invalid_request",
      "message": "customer is required.",
      "param": "customer",
      "type": "invalid_request_error"
    }
  }
  ```

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

  ```json 404 theme={}
  {
    "error": {
      "code": "resource_missing",
      "message": "Customer not found.",
      "type": "invalid_request_error"
    }
  }
  ```
</ResponseExample>