Skip to main content
POST
Create a claim

Authorizations

Authorization
string
header
required

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

Body

application/json
shipment
object
required
incidence
object
required

Response

Claim created.

The claim just created, as returned by the create-claim endpoint.

id
string
required

Unique claim ID.

number
string | null
required

Human-readable claim reference. null until assigned by the Opereit team.

status
enum<string>
required

Always CREATED on this response.

Available options:
CREATED,
UNDER_REVIEW,
PENDING_ACTION,
PENDING_REFUND,
PENDING_REFUND_AMOUNT_CONFIRMED,
RESOLVED,
CANCELED,
REJECTED,
CLOSED
status_reason
null
required

Always null on this response — a newly created claim starts at CREATED, which doesn't carry a status reason. See Status reasons.

date
string<date>
required

Date the claim was filed.

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

Equal to incidence.claimed_amount, in the smallest currency unit.

shipment
object
required
incidence
object
required
provider_id
string | null
Last modified on August 25, 2026