Retrieve a dispute

Fetches a single Hyperswitch dispute plus its org-scoped disputeExtension sidecar. If a sidecar exists but belongs to a different organization, the dispute is reported as not found (404).

Authentication

x-api-keystring

A scoped MvsPayApiKey, e.g. mvspay_live_…. Mint and scope keys from the dashboard (Settings → API Keys).

Path parameters

idstringRequired

The dispute id (Hyperswitch dispute id, or a synthetic nmi:<caseId> for NMI chargebacks).

Response

The dispute and its extension sidecar (or null).

disputeobject

A dispute. For Hyperswitch disputes this is the router’s dispute object (loosely typed; extra fields pass through). For NMI chargebacks (ADR-014) it is a synthetic shape mapped from the extension row, carrying source: "NMI" and an nmi:<caseId> dispute id.

extensionobject or null

Org-scoped sidecar persisted alongside a dispute. Tracks platform alerting and management state. For NMI-sourced chargebacks (ADR-014) hyperswitchDisputeId carries a synthetic nmi:<caseId> value. Amount fields are minor units (cents).

Errors

401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
500
Internal Server Error
502
Bad Gateway Error