> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aiinsurance.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Create, manage, and query coverage types and their fields

## Overview

Coverage types represent the lines of coverage a company offers, such as General Liability, Workers Compensation, or Auto. Each coverage type has a set of **fields** that determine what data can be recorded on events (claims and incidents) of that type.

There are two kinds of coverage types:

* **Global** coverage types (e.g., `general_liability`, `inland_marine`) are shared across all companies and cannot be created or deleted via the API.
* **Company-specific** coverage types are created and owned by a single company.

Use the Coverage Types API to list all available coverage types (global and company-specific), create company-specific coverage types, control which types are active for a company, discover which fields are available for each coverage type, or set the fields on company-specific coverage types.

***

## API Endpoints

* **[List Coverage Types](/api-reference/coverage-types/list-coverage-types)** - List all coverage types (global and company-specific) with optional label filtering
* **[Create Coverage Type](/api-reference/coverage-types/create-coverage-type)** - Create a new company-specific coverage type
* **[Delete Coverage Type](/api-reference/coverage-types/delete-coverage-type)** - Permanently delete a company-specific coverage type
* **[Set Enabled Coverage Types](/api-reference/coverage-types/set-enabled-coverage-types)** - Replace the company's enabled coverage types list
* **[Get Coverage Type Fields](/api-reference/coverage-types/get-coverage-type-fields)** - Retrieve the fields associated with a coverage type
* **[Set Coverage Type Fields](/api-reference/coverage-types/set-coverage-type-fields)** - Replace the fields on a company-specific coverage type

***

## Example: Create a Coverage Type

```json theme={null}
POST /api/external/companies/{companyId}/coverage-types

{
  "key": "vfs_general_liability",
  "label": "General Liability"
}
```

Response:

```json theme={null}
{
  "id": "vfs_general_liability"
}
```

## Example: Get Coverage Type Fields

```json theme={null}
GET /api/external/companies/{companyId}/coverage-types/general_liability/fields

{
  "coverageTypeId": "general_liability",
  "coverageTypeName": "General Liability",
  "fields": [
    "reportDate",
    "eventDescription",
    "settlementDemand",
    "indemnityPaid",
    "alaeReserveAmount"
  ],
  "metadata": {
    "coverageTypeScope": "global",
    "fieldSources": ["database", "static"]
  }
}
```