Overview

Manage policies using the Field Model V1 data structure

Field Model V1 (FMV1) policies store custom field data in a segment-based structure. Each policy contains one or more segments, where each segment represents a time period and holds policy-level and exposure-level custom field values.

Data Structure

FMV1 policies use a segments array where each segment contains:

• segmentInfo — date range (start, end) for the segment
• policy — policy-level custom field values (key-value pairs), including policyCoverages
• exposures — array of exposure objects with custom field values

The field keys available for policy and exposures are configured per company. Use the Configuration endpoint to discover available fields.

API Endpoints

Method	Endpoint	Description
GET	/v1/policies	List policies
POST	/v1/policies	Create a policy
GET	/v1/policies/{policyId}	Get a policy
DELETE	/v1/policies/{policyId}	Delete a policy
GET	/v1/policies/configuration	Get field configuration

Configuration

The configuration endpoint returns JSON Schemas for the custom fields:

• policy schema — fields for segments[].policy (including policyCoverages)
• exposure schema — fields for segments[].exposures[]

Each schema includes field types, allowed enum values (for Option Set fields), and which fields are unconditionally required.

Permissions

Operation	Permission
List, Get, Configuration	company.policy:read
Create, Delete	company.policy:create