Requires Authorization: Bearer YOUR_PRIVATE_TOKEN from a backend and partner claims enabled by Mulberry for that retailer. All records are scoped to the token's retailer and visible orders. Submit customer incident details with optional evidence into Mulberry's existing adjudication workflow. No claim decision or payout instruction is accepted. A new reference returns 201, an identical retry returns 200, and reuse with different input returns 409. Initial evidence and the claim commit together. If processing_pending is true, the saved claim needs an identical POST retry to repair pending background dispatch. Normalized input (including received_at) and the same initial filenames/content must match; attachment order may differ. Retries remain valid after a claim changes status. Use the documents endpoint for later evidence.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
API preview — rollout pendingThis contract is published for integration planning. The new claims endpoints are not yet deployed. Before testing, confirm availability and partner-claims enablement with Mulberry for your staging or production account.
See Submit claims through the API for enablement, examples, retries, and reconciliation.
400Invalid JSON, field, query, attachment or multipart request. Extra input fields are rejected.
401Missing or invalid private retailer bearer token.
403Private retailer token required, retailer inactive, or partner claims not enabled.
404Claim, warranty or covered item not found within this retailer's visible orders.
409external_claim_id already used with different input, or warranty no longer claimable.
413Entire request exceeds 10 MiB (including multipart overhead).
422The covered item cannot take a claim (for example already replaced, removed, or incident before coverage begins). The response includes message and reason.
503Temporary storage/conversion failure or another request is processing this claim. Retry the identical request with backoff; do not change external_claim_id.