List Policies

These operations work for both Smart Cyber and Smart Tech E+O.

policies(first: $first, after: $after)

Method: POST
Endpoint: Sandbox: https://api-sandbox.corvusinsurance.com/q Production: https://crowbar.corvusinsurance.com/q
Authentication: Send the headers X-API-KEY, X-USER-EMAIL, X-USER-NAME with every request. See Authentication.

The top-level policies connection returns bound and issued policies where the user in the X-USER-EMAIL header is the broker and that expire within the next 180 days. Pass first (up to 200) and after to paginate.

To list all of one client's policies regardless of expiration date, use client(id: $clientId) { policies(first: $first) { ... } } (up to 50 per page). Voided policies are excluded.

To get a single policy, use policy(id: $id). It returns unauthorized if the policy belongs to another brokerage.

For renewalQuoteRequest, see Renewals.

Arguments

Required Required to submit Optional

Pass these as variables.

List Policies arguments
Name	Type	Required	Description
first	Int	Required	Number of policies to return, up to 200
after	String	Optional	Cursor to continue from; use pageInfo.endCursor from the previous page

Response fields

Select only the fields you need in the selection set.

List Policies response fields
Name	Type	Description
policies.pageInfo.hasNextPage	Boolean!	Whether another page follows
policies.pageInfo.endCursor	String	Cursor to pass as after to get the next page
policies.edges.node.id	ID!	Id of the policy
policies.edges.node.policyNumber	String!	Policy number
policies.edges.node.productType	ProductType!	Product line of the policy
policies.edges.node.status	PolicyStatus!	Status of the policy
policies.edges.node.coverageStartsAt	Date!	Date coverage starts
policies.edges.node.coverageEndsAt	Date!	Date coverage ends
policies.edges.node.premiumCents	Int!	Premium, in cents
policies.edges.node.client	Client!	Id and name of the client
policies.edges.node.renewalQuoteRequest	QuoteRequest	Id and status of the renewal quote request, when there is one

query ListPolicies($first: Int!, $after: String) {  policies(first: $first, after: $after) {    pageInfo {      hasNextPage      endCursor    }    edges {      node {        id        policyNumber        productType        status        coverageStartsAt        coverageEndsAt        premiumCents        client {          id          name        }        renewalQuoteRequest {          id          status        }      }    }  }}

{  "first": 50}

{  "data": {    "policies": {      "pageInfo": {        "hasNextPage": false,        "endCursor": "YXJyYXljb25uZWN0aW9uOjA="      },      "edges": [        {          "node": {            "id": "dgqfo4yDRqyKu25PiDTbtQ",            "policyNumber": "CYB-123456-00",            "productType": "CYBER",            "status": "ISSUED",            "coverageStartsAt": "2025-12-01",            "coverageEndsAt": "2026-12-01",            "premiumCents": 450000,            "client": {              "id": "r_ueqcfTSheKXZJ8zwbk_g",              "name": "Test Client"            },            "renewalQuoteRequest": null          }        }      ]    }  }}