RevKeen Docs
Api reference

List disputes

Retrieve a paginated list of disputes/chargebacks with optional filters. Results are ordered by disputed date (newest first).

Related endpoints

  • GET /disputes/open — Get open disputes requiring action
  • GET /disputes/{id} — Get dispute by ID

Common errors

  • 401 unauthenticated — missing, malformed, or revoked API key.

Pagination

Offset-based with limit (default 25, max 100) and offset. The response pagination block includes total and hasMore. See the pagination guide for SDK auto-paging helpers.

GET
/disputes

Authorization

x-api-key<token>

Your RevKeen API key (powered by Unkey). Get it from Dashboard > Settings > API Keys. Use rk_sandbox_* for test mode and rk_live_* for production.

In: header

Query Parameters

status?string

Filter by dispute status

Value in"needs_response" | "under_review" | "won" | "lost" | "warning_closed" | "warning_needs_response"
resolution?string

Filter by resolution outcome

Value in"won" | "lost" | "withdrawn"
payment_id?string

Filter by original payment ID

Formatuuid
gateway?string

Filter by payment gateway (nmi, stripe, etc.)

disputed_after?string

ISO 8601 date - only disputes after this date

disputed_before?string

ISO 8601 date - only disputes before this date

needs_evidence?string

Only show disputes that need evidence submission

Value in"true" | "false"
limit?number

Number of results to return (1-100)

Default20
Range1 <= value <= 100
offset?|

Number of results to skip

Default0
Range0 <= value

Response Body

application/json

curl "https://api.revkeen.com/v2/disputes" \  -H "x-api-key: $REVKEEN_API_KEY"
{
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "public_id": "dsp_abc123xyz",
      "payment_id": "660e8400-e29b-41d4-a716-446655440000",
      "parent_transaction_id": "660e8400-e29b-41d4-a716-446655440000",
      "gateway": "string",
      "gateway_dispute_id": "chargeback_12345",
      "gateway_transaction_id": "txn_original_12345",
      "amount_minor": 10000,
      "currency": "USD",
      "reason_code": "4837",
      "reason": "Fraudulent transaction",
      "network_reason_code": "83",
      "network_reason_description": "Fraud - Card-Absent Environment",
      "customer_name": "John Doe",
      "card_brand": "visa",
      "card_last4": "4242",
      "evidence_due_by": "2024-01-25T23:59:59Z",
      "evidence_submitted": false,
      "evidence_submitted_at": null,
      "status": "needs_response",
      "resolution": null,
      "resolved_at": null,
      "disputed_at": "2024-01-15T10:30:00Z",
      "created_at": "2024-01-15T10:30:00Z"
    }
  ],
  "meta": {
    "total": 100,
    "limit": 20,
    "offset": 0,
    "has_more": true
  }
}
Empty
Empty
Edit on GitHub