---
title: "InsurancePolicyV2"
url: "https://developer-staging.agentsync.io/apis/identity/versions/1ed33a2c-924a-434c-9643-fbc531dea1b8/schemas/InsurancePolicyV2"
---

> Full API specification: https://developer-staging.agentsync.io/apis/identity/versions/1ed33a2c-924a-434c-9643-fbc531dea1b8.md

# InsurancePolicyV2

## OpenAPI definition

```yaml
openapi: 3.0.1
info:
  title: Identity API
  version: v1.275.8
servers:
  - url: https://api.sandbox.agentsync.io/id
    description: Sandbox server
  - url: https://api.agentsync.io/id
    description: Production server
components:
  schemas:
    PolicyType:
      title: PolicyType
      type: string
      description: The type of insurance policy
      enum:
        - CORPORATION
        - INDIVIDUAL
        - JOINT
      example: INDIVIDUAL
    InsurancePolicyV2:
      type: object
      required:
        - id
        - type
        - carrier
        - effectiveOn
        - policyNumber
        - certificateNumber
        - createdAt
        - updatedAt
      properties:
        id:
          type: string
          format: uuid
          description: Unique identifier for the insurance policy.
          readOnly: true
        type:
          $ref: "#/components/schemas/PolicyType"
        carrier:
          type: string
          description: Name of the insurance carrier.
        totalLimit:
          type: number
          format: double
          description: Maximum coverage limit for the policy.
        effectiveOn:
          type: string
          format: date
          description: Date the insurance policy became effective (YYYY-MM-DD).
        expiresOn:
          type: string
          format: date
          description: Date the insurance policy expires (YYYY-MM-DD).
        policyNumber:
          type: string
          description: Policy number assigned by the carrier.
        certificateNumber:
          type: string
          description: Certificate number for the policy.
        hasFile:
          type: boolean
          description: Whether a certificate file has been uploaded for this policy.
          readOnly: true
        certificateUrl:
          type: string
          format: uri
          description: Presigned download URL for the certificate file. Present only when
            hasFile is true. Expires 10 minutes after the response is generated.
          readOnly: true
          nullable: true
        createdAt:
          type: string
          format: date-time
          description: RFC3339 UTC timestamp when the record was created.
          readOnly: true
        updatedAt:
          type: string
          format: date-time
          description: RFC3339 UTC timestamp when the record was last updated.
          readOnly: true
```