List Policy Versions

curl --request GET \
  --url https://go.aiinsurance.io/api/v1/companies/{companyId}/policies/versions \
  --header 'Authorization: <api-key>'

import requests

url = "https://go.aiinsurance.io/api/v1/companies/{companyId}/policies/versions"

headers = {"Authorization": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: '<api-key>'}};

fetch('https://go.aiinsurance.io/api/v1/companies/{companyId}/policies/versions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://go.aiinsurance.io/api/v1/companies/{companyId}/policies/versions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://go.aiinsurance.io/api/v1/companies/{companyId}/policies/versions"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://go.aiinsurance.io/api/v1/companies/{companyId}/policies/versions")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "items": [
    {
      "summary": {
        "id": "550e8400-e29b-41d4-a716-446655440002",
        "policyId": "550e8400-e29b-41d4-a716-446655440001",
        "companyId": "550e8400-e29b-41d4-a716-446655440099",
        "createdAt": "2025-01-15T10:30:00.000Z",
        "policyVersion": 1,
        "versionCreatedAt": "2025-01-15T10:30:00.000Z",
        "policyStartDate": {
          "year": 2025,
          "month": 1,
          "day": 1,
          "timezone": "America/New_York"
        },
        "policyEndDate": {
          "year": 2026,
          "month": 1,
          "day": 1,
          "timezone": "America/New_York"
        },
        "fullTermPricingInfo": {
          "premium": 85000,
          "taxes": 0,
          "fees": 500,
          "brokerCommission": 0,
          "programCommission": 0,
          "pricingComponents": [
            {
              "label": "Policy Premium",
              "group": "Policy Invoice",
              "kind": "Premium",
              "earningBasis": null,
              "value": 85000
            },
            {
              "label": "Policy Fee",
              "group": "Policy Invoice",
              "kind": "Fees",
              "earningBasis": null,
              "value": 500
            }
          ]
        },
        "matchedSegments": [
          {
            "startDate": "2025-01-01",
            "endDate": "2026-01-01"
          }
        ]
      }
    },
    {
      "summary": {
        "id": "550e8400-e29b-41d4-a716-446655440003",
        "policyId": "550e8400-e29b-41d4-a716-446655440001",
        "companyId": "550e8400-e29b-41d4-a716-446655440099",
        "createdAt": "2025-01-15T10:30:00.000Z",
        "policyVersion": 2,
        "versionCreatedAt": "2025-02-01T14:00:00.000Z",
        "policyStartDate": {
          "year": 2025,
          "month": 1,
          "day": 1,
          "timezone": "America/New_York"
        },
        "policyEndDate": {
          "year": 2026,
          "month": 1,
          "day": 1,
          "timezone": "America/New_York"
        },
        "fullTermPricingInfo": {
          "premium": 102000,
          "taxes": 0,
          "fees": 500,
          "brokerCommission": 0,
          "programCommission": 0,
          "pricingComponents": [
            {
              "label": "Policy Premium",
              "group": "Policy Invoice",
              "kind": "Premium",
              "earningBasis": null,
              "value": 102000
            },
            {
              "label": "Policy Fee",
              "group": "Policy Invoice",
              "kind": "Fees",
              "earningBasis": null,
              "value": 500
            }
          ]
        },
        "matchedSegments": [
          {
            "startDate": "2025-01-01",
            "endDate": "2025-06-01"
          },
          {
            "startDate": "2025-06-01",
            "endDate": "2026-01-01"
          }
        ]
      }
    }
  ],
  "totalCount": 2
}

List Policy Versions

Lists policy versions across all policies. Unlike “List Policies” (which resolves each policy to one version), this endpoint returns every (policy, version) pair that matches the filters. A single policy can appear multiple times if multiple versions match.

Example questions this endpoint answers:

“Find all policy versions where premium exceeded $100k” — segmentScope="all", filters on premium field
“Which policy versions provided coverage on June 15?” — segmentScope={"asOf":"2025-06-15"}
“Find policies that ever matched a specific coverage type on a given date” — segmentScope={"asOf":"..."}, filters on coverage field

Query parameters (detail, segmentScope, filters, pagination, sorting) work identically to the List Policies endpoint except that timeTravelBackToDate is not available — all versions are listed.

Required permission: company.policy:read

GET

api

companies

{companyId}

policies

versions

List Policy Versions

curl --request GET \
  --url https://go.aiinsurance.io/api/v1/companies/{companyId}/policies/versions \
  --header 'Authorization: <api-key>'

import requests

url = "https://go.aiinsurance.io/api/v1/companies/{companyId}/policies/versions"

headers = {"Authorization": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: '<api-key>'}};

fetch('https://go.aiinsurance.io/api/v1/companies/{companyId}/policies/versions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://go.aiinsurance.io/api/v1/companies/{companyId}/policies/versions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://go.aiinsurance.io/api/v1/companies/{companyId}/policies/versions"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://go.aiinsurance.io/api/v1/companies/{companyId}/policies/versions")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "items": [
    {
      "summary": {
        "id": "550e8400-e29b-41d4-a716-446655440002",
        "policyId": "550e8400-e29b-41d4-a716-446655440001",
        "companyId": "550e8400-e29b-41d4-a716-446655440099",
        "createdAt": "2025-01-15T10:30:00.000Z",
        "policyVersion": 1,
        "versionCreatedAt": "2025-01-15T10:30:00.000Z",
        "policyStartDate": {
          "year": 2025,
          "month": 1,
          "day": 1,
          "timezone": "America/New_York"
        },
        "policyEndDate": {
          "year": 2026,
          "month": 1,
          "day": 1,
          "timezone": "America/New_York"
        },
        "fullTermPricingInfo": {
          "premium": 85000,
          "taxes": 0,
          "fees": 500,
          "brokerCommission": 0,
          "programCommission": 0,
          "pricingComponents": [
            {
              "label": "Policy Premium",
              "group": "Policy Invoice",
              "kind": "Premium",
              "earningBasis": null,
              "value": 85000
            },
            {
              "label": "Policy Fee",
              "group": "Policy Invoice",
              "kind": "Fees",
              "earningBasis": null,
              "value": 500
            }
          ]
        },
        "matchedSegments": [
          {
            "startDate": "2025-01-01",
            "endDate": "2026-01-01"
          }
        ]
      }
    },
    {
      "summary": {
        "id": "550e8400-e29b-41d4-a716-446655440003",
        "policyId": "550e8400-e29b-41d4-a716-446655440001",
        "companyId": "550e8400-e29b-41d4-a716-446655440099",
        "createdAt": "2025-01-15T10:30:00.000Z",
        "policyVersion": 2,
        "versionCreatedAt": "2025-02-01T14:00:00.000Z",
        "policyStartDate": {
          "year": 2025,
          "month": 1,
          "day": 1,
          "timezone": "America/New_York"
        },
        "policyEndDate": {
          "year": 2026,
          "month": 1,
          "day": 1,
          "timezone": "America/New_York"
        },
        "fullTermPricingInfo": {
          "premium": 102000,
          "taxes": 0,
          "fees": 500,
          "brokerCommission": 0,
          "programCommission": 0,
          "pricingComponents": [
            {
              "label": "Policy Premium",
              "group": "Policy Invoice",
              "kind": "Premium",
              "earningBasis": null,
              "value": 102000
            },
            {
              "label": "Policy Fee",
              "group": "Policy Invoice",
              "kind": "Fees",
              "earningBasis": null,
              "value": 500
            }
          ]
        },
        "matchedSegments": [
          {
            "startDate": "2025-01-01",
            "endDate": "2025-06-01"
          },
          {
            "startDate": "2025-06-01",
            "endDate": "2026-01-01"
          }
        ]
      }
    }
  ],
  "totalCount": 2
}

Authorizations

Authorization

string

header

required

API key authentication. Send your raw API key as the Authorization header value with NO scheme prefix — Authorization: YOUR-API-KEY. Do NOT prefix it with Bearer or ApiKey , and do not use an X-API-Key header; those are not accepted.

Path Parameters

companyId

string<uuid>

required

Company identifier

Query Parameters

page

integer

default:1

Page number (1-based, default 1).

Required range: x >= 1

detail

enum<string>

required

Detail level. summary returns lightweight results with matched segment date ranges. full includes complete field data for each scope-matched segment.

Available options:

summary,

full

segmentScope

string

default:"all"

JSON-encoded segment scope filter. Controls which segments within each version participate in filtering. Optional — defaults to "all" when omitted. Values:

"all" — every segment
{"asOf":"YYYY-MM-DD"} — point-in-time
{"fromDate":"YYYY-MM-DD","toDate":"YYYY-MM-DD"} — date range

filters

string

JSON-encoded array of field filters. Each filter targets a field in the segment's data object and supports type-specific operators. Supported field types: text, number, boolean, date, currency, optionSet, address, join, textList, numberList, optionSetList, addressList.

List-cardinality types support operators: listIncludes (textList, numberList, addressList), listIn, listAll, listExcludes (optionSetList). The join type supports the in operator.

See the Configuration API for available field reference IDs.

sortBy

enum<string>

Field to sort results by

Available options:

policyId,

createdAt,

versionCreatedAt

sortDirection

enum<string>

default:desc

Sort direction (default desc)

Available options:

asc,

desc

Response

Paginated list of policy versions

Paginated list of policy results.

Why this differs from the entity list shape. A non-policy entity list (GET /entities/{entityType}) returns flat items, each a single { id, fieldModelV1Data, … } record. A policy list item instead carries a summary object (and, with detail=full, a segments array) — it has no single top-level field-data blob. This is by design: a Policy is a segmented entity assembled from immutable transactions, so its field data lives per-segment rather than in one flat record. The summary gives the policy-level view (id, full-term info, matched segment date ranges) and segments carries the per-segment data object when requested.

items

object[]

required

Show child attributes

totalCount

integer

required

Total number of matching results across all pages

⌘I

Getting Started

User

Entities

Event Lifecycle

Policy Transactions

Financials

Rating

Notes

Tasks

Configuration Management

Company Files

Forms

Document Generation

Submission Parsing

Reference

List Policy Versions

Authorizations

Path Parameters

Query Parameters

Response