---
title: "Create Policy"
method: POST
path: "/api/policies"
---

# Create Policy

`POST /api/policies`

## Request

- Base URL: `https://api.gethesperai.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.gethesperai.com/api/policies`
- Auth: none declared

Register a new pet policy. Idempotent on (team_id, policy_number).

## Headers

- `X-Team-Id` string, nullable

## Request body

- PolicyIn
  - `policy_number` string, required
  - `plan_name` string
  - `coverage_type` string
  - `effective_date` string, required
  - `renewal_date` string, required
  - `deductible_usd` number, required
  - `max_annual_payout_usd` number, required
  - `accident_waiting_period_days` integer
  - `illness_waiting_period_days` integer
  - `declared_pre_existing` string[]
  - `exclusions` string[]
  - `raw_exclusion_texts` string[]
  - `policy_status` string
  - `source_document_filename` string, nullable
  - `reimbursement_rate` number
  - `sub_limits` object
  - `notes` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/gethesperai/apis/hesper-ai-claims-investigator.md) - [All operations](https://skmtc.dev/gethesperai/apis/hesper-ai-claims-investigator/llms.txt) - [OpenAPI document](https://skmtc.dev/gethesperai/apis/hesper-ai-claims-investigator/revisions/1a031ee6acf1?raw)