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

> Lista disputes.

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

## Filtros

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

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

<ParamField query="payment_intent" type="string">
  Filtra por payment intent (`pi_*`).
</ParamField>

<ParamField query="status" type="string">
  Filtra por status: `needs_response`, `under_review`, `won`, `lost` e variantes
  `warning_*`.
</ParamField>

<ParamField query="created[gte]" type="string">
  Filtra disputes criados a partir de um timestamp ISO-8601 ou Unix seconds.
</ParamField>

<ParamField query="created[gt]" type="string">
  Filtra disputes criados depois de um timestamp ISO-8601 ou Unix seconds.
</ParamField>

<ParamField query="created[lte]" type="string">
  Filtra disputes criados até um timestamp ISO-8601 ou Unix seconds.
</ParamField>

<ParamField query="created[lt]" type="string">
  Filtra disputes criados antes de um timestamp ISO-8601 ou Unix seconds.
</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/disputes?charge=ch_123&limit=10" \
    -H "Authorization: Bearer {{API_KEY}}"
  ```
</RequestExample>

<ResponseExample>
  ```json Response 200 theme={}
  {
    "object": "list",
    "data": [
      {
        "id": "dp_123",
        "object": "dispute",
        "amount": 15000,
        "charge": "ch_123",
        "closed_at": null,
        "created_at": "2026-05-22T03:00:00Z",
        "currency": "brl",
        "customer": "cus_123",
        "evidence": {
          "file": "file_123"
        },
        "evidence_details": {
          "due_by": "2026-05-29T03:00:00Z",
          "has_evidence": true,
          "past_due": false,
          "submission_count": 1
        },
        "is_charge_refundable": true,
        "livemode": true,
        "metadata": {},
        "payment_intent": "pi_123",
        "reason": "fraudulent",
        "status": "under_review",
        "updated_at": "2026-05-22T18:10:00Z"
      }
    ],
    "has_more": false,
    "url": "/v1/disputes"
  }
  ```
</ResponseExample>