Skip to main content
GET
Retrieve a case

Authorizations

Authorization
string
header
required

Use your API key as the username. No password is required.

Path Parameters

case_id
string
required

Response

200 - application/json

Returns the case.

cardholder
object

Details of the cardholder.

case_id
string

Unique identifier for the case.

Example:

"case_abc123"

claim_id
string | null

The claim this case belongs to. Read-only. Cases are added to claims using the claims API.

Example:

"claim_abc123"

created
string<date-time>

When the case was created. ISO 8601 format.

Example:

"2026-04-01T00:00:00.000Z"

custom_fields
object

Custom key-value pairs for storing additional data with your cases. See Custom Fields documentation for more details.

dispute
object

Dispute details for the case.

issuer_evidence
object

Issuer evidence for the dispute.

merchant
object

Details of the merchant.

program_id
string | null

Your unique identifier for the card program the case belongs to.

Maximum string length: 126
Example:

"550e8400-e29b-41d4-a716-446655440000"

reason
enum<string>
deprecated

Deprecated. Use dispute.reason instead.

Available options:
canceled_or_returned,
cash_not_received,
credit_not_processed,
duplicate_charge,
fraud,
incorrect_amount,
invalid_authorization,
other,
product_counterfeit,
product_not_as_described,
product_not_received,
subscription_canceled
Example:

"fraud"

resolution_due_date
string<date-time> | null

The deadline by which the case must be resolved. Read-only. ISO 8601 format.

Example:

"2026-07-01T00:00:00.000Z"

status
enum<string>

The status of the case.

Available options:
created,
chargeback_filed,
chargeback_represented,
prearb_received,
prearb_filed,
prearb_rebutted,
arbitration_filed,
won,
lost,
accepted,
rejected,
expired,
withdrawn,
merchant_credited
Example:

"created"

transaction
object

Details of the disputed transaction.