Skip to main content
GET
List claims

Authorizations

Authorization
string
header
required

HTTP Basic Auth using your API key. Send Authorization: Basic base64(key_id:key_secret).

Query Parameters

limit
integer
default:50

Number of items to return per request.

Required range: 1 <= x <= 100
cursor
string

Opaque cursor from a previous response. Omit on the first request.

status
enum<string>

Filter by claim status. Current stage of the claim.

  • CREATED: claim created, not yet reviewed.
  • UNDER_REVIEW: being reviewed by the carrier.
  • PENDING_ACTION: action is required from Opereit's team before it can move forward.
  • PENDING_REFUND: a refund is being processed; amount not confirmed yet.
  • PENDING_REFUND_AMOUNT_CONFIRMED: refund amount confirmed, not paid yet.
  • RESOLVED: the claim has been resolved.
  • CANCELED: the claim was canceled.
  • REJECTED: the claim was rejected by the carrier.
  • CLOSED: the claim is closed.

A claim is considered closed (no longer open) when it's REJECTED (for any reason), or CANCELED with a status reason of CREATED_INCORRECTLY or SHIPMENT_NOT_CLAIMABLE_YET. Any other status counts as open, and an open claim is what blocks a new claim on the same tracking number (see POST /v1/claims).

Available options:
CREATED,
UNDER_REVIEW,
PENDING_ACTION,
PENDING_REFUND,
PENDING_REFUND_AMOUNT_CONFIRMED,
RESOLVED,
CANCELED,
REJECTED,
CLOSED
carrierId
string

Filter by carrier ID (e.g. ups, fedex).

trackingNumber
string

Filter by the shipment's carrier tracking number.

fromDate
string<date>

Return claims with a claim date on or after this date. Format YYYY-MM-DD.

toDate
string<date>

Return claims with a claim date on or before this date. Format YYYY-MM-DD.

Response

Cursor-paginated list of claims.

data
object[]
required
pagination
object
required
Last modified on August 25, 2026