Preview. The API is shared with design partners and may change before launch. Register interest for sandbox access.

Events

Events tell you when something changed. Phew sends them to your webhook endpoints, and you can also list them through the API for 30 days.

The event object

{
  "id": "evt_01JD9C2E4G6J8L0N2Q4S6U8W0Y",
  "object": "event",
  "type": "claim.resolved",
  "created_at": "2027-03-19T15:02:48Z",
  "livemode": true,
  "merchant": "mer_01JD7Z4K2Q8V6N3R5T7W9Y1A3C",
  "api_version": "2026-10-01",
  "data": {
    "object": {
      "id": "clm_01JDB4X6Z8B0D2F4H6K8M0P2R4",
      "object": "claim",
      "status": "resolved",
      "outcome": "repair"
    },
    "previous_attributes": { "status": "in_repair" }
  }
}

data.object is the object as it was when the event happened, rendered in your pinned api_version. data.previous_attributes lists changed fields on *.updated events.

Event types

Type	When
`policy.created`	A policy was created
`policy.cancelled`	A policy was cancelled, by you or by the customer through Phew
`policy.expired`	A policy reached its end date
`claim.created`	A customer opened a claim
`claim.updated`	A claim changed status
`claim.resolved`	A claim was resolved; `outcome` is set
`merchant.updated`	A merchant’s status or details changed (partners)
`settlement.statement.created`	A monthly statement is ready
`ping`	A test event from the test endpoint

New event types may be added at any time. Ignore types you don’t recognise.

List events

GET api.getphew.com/v1/events webhooks:manage

Filter with type (for example claim.*) and created[gte]; paginate with limit and starting_after. Useful to catch up after downtime.

Retrieve an event

GET api.getphew.com/v1/events/{id} webhooks:manage