Validate Policies (Batch)

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

{
  "items": [
    {
      "policyId": "550e8400-e29b-41d4-a716-446655440001",
      "validatedAt": "2026-04-14T18:30:00.000Z",
      "summary": {
        "totalChecks": 8,
        "passed": 8,
        "failed": 0,
        "skipped": 0
      },
      "results": [
        {
          "check": "contiguity",
          "status": "pass",
          "scope": "version:1"
        },
        {
          "check": "versionSequentiality",
          "status": "pass",
          "scope": "policy"
        }
      ]
    },
    {
      "policyId": "550e8400-e29b-41d4-a716-446655440002",
      "validatedAt": "2026-04-14T18:30:00.000Z",
      "summary": {
        "totalChecks": 13,
        "passed": 12,
        "failed": 1,
        "skipped": 0
      },
      "results": [
        {
          "check": "hashCorrectness",
          "status": "fail",
          "scope": "version:2",
          "message": "Segment 0 hash mismatch: stored a1b2c3d4e5f6, computed f6e5d4c3b2a1"
        },
        {
          "check": "versionSequentiality",
          "status": "pass",
          "scope": "policy"
        }
      ]
    }
  ],
  "totalCount": 47
}

Validation

Validate Policies (Batch)

Runs data consistency checks against multiple policies in a single request and returns paginated results. This is a read-only diagnostic endpoint — no data is modified.

Three modes control which policies are validated (mutually exclusive):

Explicit pairs (policyVersions) — validate specific policy/version combinations. Pagination parameters are ignored.
Time travel (timeTravelBackToDate) — validate the latest version of each policy as of a historical point in time. Paginated via limit/offset.
Default (neither parameter) — validate the latest version of all policies in the company. Paginated via limit/offset.

The same eight checks from the single-policy validation endpoint are available. Use the checks parameter to select a subset.

Available checks

Check	Scope	What it validates
`contiguity`	version	Segments form a contiguous date range with no gaps or overlaps
`fullTermInvariance`	version	Billing and policy metadata fields are constant across all segments in a version
`hashCorrectness`	version	Stored segment hash matches the computed hash of the segment data
`noDuplicateSegments`	version	No adjacent segments have identical hashes
`transactionSegmentExistence`	version	At least one segment exists for the version
`versionSequentiality`	policy	Versions are sequential starting from 1 with no gaps
`cancelEarnedPremium`	policy	Cancel transaction premium matches earned premium through the cancellation date
`cancelReinstatePremium`	policy	Reinstate transaction premium matches the pre-cancel version premium

Required permission: company.policy:read

GET

api

external

companies

{companyId}

policies

validate

Validate Policies (Batch)

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

{
  "items": [
    {
      "policyId": "550e8400-e29b-41d4-a716-446655440001",
      "validatedAt": "2026-04-14T18:30:00.000Z",
      "summary": {
        "totalChecks": 8,
        "passed": 8,
        "failed": 0,
        "skipped": 0
      },
      "results": [
        {
          "check": "contiguity",
          "status": "pass",
          "scope": "version:1"
        },
        {
          "check": "versionSequentiality",
          "status": "pass",
          "scope": "policy"
        }
      ]
    },
    {
      "policyId": "550e8400-e29b-41d4-a716-446655440002",
      "validatedAt": "2026-04-14T18:30:00.000Z",
      "summary": {
        "totalChecks": 13,
        "passed": 12,
        "failed": 1,
        "skipped": 0
      },
      "results": [
        {
          "check": "hashCorrectness",
          "status": "fail",
          "scope": "version:2",
          "message": "Segment 0 hash mismatch: stored a1b2c3d4e5f6, computed f6e5d4c3b2a1"
        },
        {
          "check": "versionSequentiality",
          "status": "pass",
          "scope": "policy"
        }
      ]
    }
  ],
  "totalCount": 47
}

Authorizations

Authorization

string

header

required

API key authentication. Include your API key in the Authorization header.

Path Parameters

companyId

string<uuid>

required

Company identifier

Query Parameters

policyVersions

string

Comma-separated list of policyId:version pairs to validate. Example: pol-abc:1,pol-def:2,pol-abc:3.

Each pair must have a non-empty policy ID and a positive integer version. Multiple versions of the same policy are allowed.

When provided, limit and offset are ignored — all requested pairs are returned.

Mutually exclusive with timeTravelBackToDate.

timeTravelBackToDate

string<date-time>

ISO 8601 timestamp. Validates the latest version of each policy that has at least one transaction created on or before this date. Policies with no transactions by this date are excluded.

Mutually exclusive with policyVersions.

checks

string

Comma-separated list of check names to run (e.g., contiguity,hashCorrectness). If omitted, all checks run. Unrecognized check names are silently ignored. If all provided names are unrecognized, all checks run (same as omitting the parameter). Check names are case-sensitive.

limit

integer

required

Maximum number of policies to return per page. Required for all requests, though it is ignored when policyVersions is provided.

Required range: x >= 1

offset

integer

default:0

Number of policies to skip before returning results. Defaults to 0. Ignored when policyVersions is provided.

Required range: x >= 0

Response

Paginated validation results

Paginated list of validation results for multiple policies.

items

object[]

required

Validation results for each policy in this page

Show child attributes

totalCount

integer

required

Total number of policies matching the query (before pagination). Use with limit and offset to page through results.

Example:

47

Validate Policy Get Policies Configuration

⌘I

Documentation Index

Authorizations

Path Parameters

Query Parameters

Response