Claims

Customers make claims directly with Phew, online or by phone. Claims are read-only through the API: you can follow them to keep your support team informed, but you never handle the assessment. Claim details are limited to what you need; descriptions and photos from the customer are never shared.

The claim object

{
  "id": "clm_01JDB4X6Z8B0D2F4H6K8M0P2R4",
  "object": "claim",
  "policy": "pol_01JD7QB2N4R6T8V0X2Z4B6D8F0",
  "order_reference": "100482",
  "status": "resolved",
  "type": "accidental_damage",
  "outcome": "repair",
  "opened_at": "2027-03-14T08:21:05Z",
  "resolved_at": "2027-03-19T15:02:47Z"
}

status enum

open, in_review, in_repair, resolved or withdrawn.

type enum

accidental_damage or breakdown.

outcome enum

Set when resolved: repair, replacement, store_credit, cash_settlement or declined.

When the outcome is store_credit, the customer receives credit to spend with you, and the amount appears on your settlement statement.

Retrieve a claim

GET api.getphew.com/v1/claims/{id} claims:read

List claims

GET api.getphew.com/v1/claims claims:read

Query parameters

policy string

Only claims on this policy.

status enum

Filter by status.

limit, starting_after integer, string

Pagination.

Events

claim.created, claim.updated and claim.resolved. See Events.