v1

latestOpenAPI 3.1.02026-07-2684271522.2 KB

Disputes

Get Dispute

Retrieves the details of an existing dispute.

Retrieves a dispute by ID, including its evidence, evidence submission details, payment method details, and associated balance transactions.

get/v1/disputes/{dispute_id}

Path parameters

dispute_idstring required

Example:fdp_01J9XR8M3K7VZ8N2YB4WJ6T0RA

Response

An envelope wrapping a single dispute object.

Example response

{
  "dispute": {
    "dispute_id": "fdp_01J9XR8M3K7VZ8N2YB4WJ6T0RA",
    "payment_intent_id": "fpi_01J9XR8M3K7VZ8N2YB4WJ6T0RA",
    "checkout_session_id": "fcs_01J9XR8M3K7VZ8N2YB4WJ6T0RA",
    "amount": 2500,
    "currency": "usd",
    "charge_id": "fch_01J9XR8M3K7VZ8N2YB4WJ6T0RA",
    "metadata": {
      "order_id": "8842",
      "channel": "shopify"
    },
    "created_at": "2026-06-15T14:30:00Z",
    "status": "lost",
    "reason": "bank_cannot_process",
    "is_charge_refundable": false,
    "evidence": {},
    "evidence_details": {},
    "payment_method_details": {},
    "test_mode": false,
    "client_reference_id": "obj_01J9XR8M3K7VZ8N2YB4WJ6T0RA"
  }
}