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.