Hermos API

List Disputes

Synced disputes, newest opened first. Groups: needs_response awaits the merchant (including an inquiry whose deadline is still open); stopped_early holds prevented alerts; paypal holds PayPal cases; disputes holds every other case. Customer name/email are included only with customers:read.

GET/disputes

Synced disputes, newest opened first. Groups: needs_response awaits the merchant (including an inquiry whose deadline is still open); stopped_early holds prevented alerts; paypal holds PayPal cases; disputes holds every other case. Customer name/email are included only with customers:read.

Authorization

AuthorizationBearer <token>

In: header

Query Parameters

cursor?string

Opaque signed cursor. Return it unchanged; valid for 24 hours.

Length1 <= length <= 8192
limit?integer
Range1 <= value <= 100
Default50
group?string

Value in

  • "all"
  • "needs_response"
  • "stopped_early"
  • "disputes"
  • "paypal"
product?string

Opaque product ID.

Match^prd_[0-7][0-9abcdefghjkmnpqrstvwxyz]{25}$(?![\s\S])
created_from?string

RFC 3339 UTC timestamp; only the Z suffix is accepted.

Formatdate-time
created_to?string

RFC 3339 UTC timestamp; only the Z suffix is accepted.

Formatdate-time

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/disputes"
{  "data": [    {      "object": "dispute",      "id": "string",      "livemode": true,      "created_at": "2019-08-24T14:15:22Z",      "processor_id": "string",      "processor_account": "string",      "payment": "string",      "rail": "stripe",      "amount": {        "amount": -9007199254740991,        "currency": "string"      },      "status": "inquiry",      "awaiting_merchant": true,      "reason": "string",      "network_reason_code": "string",      "evidence_due_at": "string",      "opened_at": "2019-08-24T14:15:22Z",      "closed_at": "string",      "submitted_at": "string",      "customer": {        "id": "string",        "name": "string",        "email": "string"      },      "product": {        "id": "string",        "name": "string"      },      "payment_method": {        "type": "string",        "brand": "string",        "last4": "string"      },      "payment_created_at": "string",      "processor_dashboard_url": "http://example.com"    }  ],  "pagination": {    "next_cursor": "string",    "has_more": true,    "as_of": "2019-08-24T14:15:22Z"  },  "request_id": "266ea41d-adf5-480b-af50-15b940c2b846",  "source": "primary"}