List Disputes

Retrieve a list of disputes with optional filtering.

GEThttps://api.uprails.com/disputes/list

Returns a list of disputes. The disputes are returned sorted by creation date, with the most recent disputes appearing first. You can filter the results by various parameters.

Monitoring Disputes

Use status filters to find disputes that need attention. Filter byneeds_response to see disputes requiring evidence submission.

Request Example

curl "https://api.uprails.com/disputes/list?limit=10&status=needs_response" \
  -H "api-key: snd_YOUR_API_KEY"

Query Parameters

limitintegerdefault: 10

Number of disputes to return (max: 100)

offsetintegerdefault: 0

Number of disputes to skip

payment_idstring

Filter disputes by payment ID

statusstring

Filter disputes by status

Enum:needs_responseunder_reviewwonlostacceptedexpired

created_gtestring

Filter disputes created after this timestamp (ISO 8601)

created_ltestring

Filter disputes created before this timestamp (ISO 8601)

Response

200OK

{
  "data": [
    {
      "dispute_id": "dis_1234567890abcdef",
      "payment_id": "pay_abcdef1234567890",
      "merchant_id": "mer_xyz789",
      "status": "needs_response",
      "amount": 1000,
      "currency": "USD",
      "reason": "fraudulent",
      "evidence_due_by": "2024-01-25T23:59:59Z",
      "created": "2024-01-15T10:00:00Z",
      "updated": "2024-01-15T10:00:00Z"
    },
    {
      "dispute_id": "dis_0987654321fedcba",
      "payment_id": "pay_xyz1234567890abc",
      "merchant_id": "mer_xyz789",
      "status": "won",
      "amount": 500,
      "currency": "USD",
      "reason": "product_not_received",
      "evidence_due_by": "2024-01-20T23:59:59Z",
      "created": "2024-01-10T14:00:00Z",
      "updated": "2024-01-22T09:00:00Z"
    }
  ],
  "total_count": 15,
  "has_more": true
}

Common Filters

Disputes Needing Response

curl "https://api.uprails.com/disputes/list?status=needs_response" \
  -H "api-key: snd_YOUR_API_KEY"

Recent Disputes

curl "https://api.uprails.com/disputes/list?created_gte=2024-01-01T00:00:00Z" \
  -H "api-key: snd_YOUR_API_KEY"