post
https://api.shipmonk.com/v1/integrations/claims/shipping
Files a shipping claim.
Several fields are conditionally required depending on initialResolution and category; see the field descriptions on FileShippingClaimInput for the exact conditions. A structurally valid request can still be rejected if those conditions are not met.
To help us process the claim quickly, include any relevant supporting documents in the documents field. If they are omitted, we may need to request them later, which can delay processing of the claim.
Initial Resolution and Reship Fields
initialResolution governs which reship-related fields are permitted.
| Value | reshippedOrder | newReshipOrderPreferences | Notes |
|---|---|---|---|
already_reshipped | Required | Forbidden | Order was already reshipped elsewhere. |
reship_requested | Forbidden | Required | Customer asked for a reship; the reship order is created immediately, or at submitAt if provided. |
reship_when_approved | Forbidden | Required | Reship pending approval; the reship order is not created until approved, so submitAt must be null. |
reship_not_requested | Forbidden | Forbidden | No reship involved. |
reship_or_refund | Forbidden | Forbidden | Reserved, only valid when MonkProtect is enabled. |
Category Values
Describes the type of shipping issue being claimed.
| Value | Description |
|---|---|
null | Default |
lost_in_transit | The shipment was lost while in transit and never delivered. |
damaged_in_transit | The shipment's packaging or contents were damaged while in transit. Requires at least one document with documentType = damage_photo_packaging. |
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…