List Disputes

List the card disputes — chargebacks and the pre-dispute inquiries that precede them — raised against payments you've taken through Truemed. Use it to drive a disputes queue in your own dashboard, surface disputes whose evidence deadline is approaching, or reconcile against your records by processor dispute ID. Results are scoped to the sales channel your API key authenticates as: you only ever see disputes on your own payments. Disputes are returned newest first and paginated with `page` / `page_size` (default 30 per page, max 100). The response `pagination` object reports `current_page`, `page_size`, `total_count`, and `last_page`. ## Request Notes All filters are optional and combine with AND: - `state`, `phase`, `reason` — exact match on the canonical enums. See the Get Dispute endpoint for the full state model. - `amount_gte` / `amount_lte` — disputed amount in **cents**, inclusive on both bounds. - `created_gte` / `created_lte` — dispute creation time, **inclusive** on both bounds. Pass ISO 8601 datetimes, e.g. `2026-01-01T00:00:00Z`. - `due_before` — only disputes whose evidence deadline (`due_by`) falls **strictly before** this datetime. Disputes with no deadline — inquiries and already-resolved disputes both have a null `due_by` — are excluded by this filter. Use it together with `state=needs_response` to build a "deadline approaching" view. ## Response Notes Each item is the same `Dispute` object returned by Get Dispute. Use the stable `dispute_id` (a Truemed UUID) for the detail, accept, and metadata endpoints; use `processor_dispute_id` (e.g. Stripe `du_…`) to reconcile against the processor. State, amounts, and deadlines are read-only — they advance only through processor events, never through this API.