Skip to main content
GET
Get a claim

Authorizations

Authorization
string
header
required

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

Path Parameters

id
string
required

ID of the claim.

Response

The claim.

A claim with full shipment and incidence details, as returned by the get-by-id endpoint.

id
string
required

Unique claim ID.

number
string | null
required

Human-readable claim reference, if assigned.

status
enum<string>
required

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
status_reason
object | null
required

Set when status is PENDING_ACTION, CANCELED, or REJECTED. null for every other status.

date
string<date>
required

Date the claim was filed.

carrier_id
string
required

Carrier identifier.

created_at
string<date-time>
required
updated_at
string<date-time>
required
total_amount
integer
required

Sum of the claimed amounts on this claim, in the smallest currency unit.

shipment
object
required
incidence
object
required
provider_id
string | null

Provider identifier, if one was set.

Last modified on August 25, 2026