---
title: "List all Insurance Policies"
method: GET
path: "/2024-09/insurances/policies"
tags: ["Insurance"]
---

# List all Insurance Policies

`GET /2024-09/insurances/policies`

Retrieve a list of insurance policies.

Required authorization scope: `public.insurance_policy:read`

## Query parameters

- `page` integer
- `per_page` integer
- `easyship_shipment_id` string
- `state` 'pending_request' | 'confirmed' | 'failed' | 'pending_void' | 'voided'
- `recipient` 'buyer' | 'merchant'
- `source` 'cloud' | 'efulfilment' | 'external'

## Response `200`

list of insurances

- InsuranceList — List of insurances
  - `insurance_policies` Insurance[]
    - `easyship_insurance_id` string — Easyship insurance ID
    - `insurance_fee` number — Insurance fee
    - `total_insured_value` number — Amount to insure with Easyship's insurance provider.
    - `currency` InsuredCurrency — unresolved $ref
    - `tracking_number` string, nullable
    - `recipient` 'buyer' | 'merchant' — Recipient type
    - `state` 'pending_request' | 'confirmed' | 'failed' | 'pending_void' | 'voided'
    - `claim_state` 'not_filed' | 'filed_by_client' | 'filed_to_courier_damaged' | 'filed_to_courier_lost' | 'rejected_damaged' | 'rejected_lost' | 'accepted_damaged' | 'accepted_lost' | 'voided' — Claim state of the insurance
    - `easyship_shipment_id` EasyshipShipmentId — unresolved $ref
    - `tracking_id` string, uuid, nullable — Tracking ID
    - `source` 'cloud' | 'efulfilment' | 'external' — Source of the insured shipment
  - `meta` MetaWithPagination
    - `pagination` Pagination — Pagination
      - `next` integer, nullable
      - `count` integer, nullable — The total number of items. The `null` value is used with countless pagination (used for faster response on large datasets, like shipments).
      - `page` integer — Current page
    - `request_id` string — An unique ID represent the request.

---

[API](https://skmtc.net/easyship/apis/easyship-public-api.md) · [All operations](https://skmtc.net/easyship/apis/easyship-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/easyship/easyship-public-api/revisions/71d737a5fcbf/schema)