Listar disputas

Lista disputes em ordem decrescente de criação.

Filtros

string

Filtra por charge (ch_*).

string

Filtra por customer (cus_*).

string

Filtra por payment intent (pi_*).

string

Filtra por status.

Valor	Descrição
`warning_needs_response`	Alerta antecipado aguardando resposta.
`warning_under_review`	Alerta antecipado em análise.
`warning_closed`	Alerta antecipado encerrado.
`needs_response`	Aguardando envio da defesa.
`under_review`	Defesa em análise.
`won`	Contestação decidida a favor da organização.
`lost`	Contestação decidida contra a organização.

string

Filtra disputes criados a partir de um timestamp ISO-8601 ou Unix seconds.

string

Filtra disputes criados depois de um timestamp ISO-8601 ou Unix seconds.

string

Filtra disputes criados até um timestamp ISO-8601 ou Unix seconds.

string

Filtra disputes criados antes de um timestamp ISO-8601 ou Unix seconds.

string

Alias de created[gte], aceito para filtrar por created_at.

string

Alias de created[gt], aceito para filtrar por created_at.

string

Alias de created[lte], aceito para filtrar por created_at.

string

Alias de created[lt], aceito para filtrar por created_at.

integer

Quantidade de itens, de 1 a 100.

string

Cursor para a próxima página.

string

Cursor para a página anterior.

curl -X GET "https://api.chargefy.io/v1/disputes?charge=ch_A3LWjMBPhF5c4cQ6&limit=10" \
  -H "Authorization: Bearer {{API_KEY}}"

200

{
  "object": "list",
  "data": [
    {
      "id": "dp_Wkd9eY49VkxeFQJF",
      "object": "dispute",
      "amount": 15000,
      "charge": "ch_A3LWjMBPhF5c4cQ6",
      "closed_at": null,
      "created_at": "2026-05-22T03:00:00Z",
      "currency": "brl",
      "customer": "cus_C51BzbRPd5GAGb41",
      "evidence": {
        "file": "file_RX6sMjA9euCviWP5"
      },
      "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_1oeLQDejwquFSboz",
      "reason": "fraudulent",
      "status": "under_review",
      "updated_at": "2026-05-22T18:10:00Z"
    }
  ],
  "has_more": false,
  "url": "/v1/disputes"
}

Erros comuns

400

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

401

{
  "error": {
    "code": "authentication_failed",
    "message": "Invalid API key provided.",
    "type": "authentication_error"
  }
}

Fundamentos da API

Objetos de sistema

Webhooks e eventos

SDKs

MCP

Filtros

Erros comuns

​Filtros

​Erros comuns

Filtros

Erros comuns