# Every renewal demands the loss run. Now it has a schema.

The carrier's claims history on a policy, as typed data your agent can read, check and request.



**Every market prices an account on its loss run.** It still arrives as a PDF. **Now your agent can read it.**

## The document underwriters read first.

A point-in-time report of every claim on a policy, valued as of one date, from the carrier that held it.

The carrier's claims system produces it on request from the insured or their agent of record. Underwriters demand it at every renewal and every market submission, usually three to five years of history per line. Buyers demand it in due diligence. Few markets price a risk on the insured's own account of its losses.

Three numbers carry the report. **Paid** is money the carrier actually issued. The **reserve** is the carrier's booked estimate of what remains to pay on an open claim; a reserve is carrier accounting, not a promise. **Incurred** is paid plus reserve, and it is the figure underwriting prices on. An open claim can move all three after the valuation date, which is why the market always asks for a freshly valued run.

Getting one is a rights question with a clock on it: many states set a statutory deadline for carriers to produce loss runs after a written request, commonly 10 to 30 days. The exact rule varies by state, so confirm your state's before relying on a number.

- **The numbers:** Paid went out. Reserve is booked for the rest. Incurred is both.
- **Issued by:** The carrier that held the policy, from its claims system.
- **Demanded by:** Anyone pricing or buying the account, at every renewal.
- **Valuation:** Every figure is true as of one date. Open claims move after it.
- **Deadline:** Often due 10 to 30 days after a written request, by state.

## One document, thirteen typed fields.

The shape every loss run resolves to, whichever carrier produced it. Free, with no key.

| Field | Type | Meaning | Source |
|---|---|---|---|
| `carrier` | string | The issuing carrier: the only authoritative source. | Carrier claims system |
| `insured` | string | Named insured on the policy. | Carrier claims system |
| `policy_number` | string | The policy the history covers. | Carrier claims system |
| `term_start · term_end` | date | The policy period covered. | Carrier claims system |
| `valuation_date` | date | The date every figure is true as of. | Carrier claims system |
| `claims[].claim_number` | string | The carrier's claim identifier. | Carrier claims system |
| `claims[].date_of_loss` | date | When the loss occurred, not when reported. | Carrier claims system |
| `claims[].cause_of_loss` | string | Peril code: wind_hail, water_damage, theft. | Carrier claims system |
| `claims[].status` | open | closed | Open figures can still move. | Carrier claims system |
| `claims[].paid` | money | Dollars issued to date. | Carrier accounting |
| `claims[].reserve` | money | Booked estimate of what remains to pay. | Carrier accounting |
| `claims[].incurred` | money | Paid plus reserve: what underwriting prices on. | Derived |
| `totals` | object | Sums and counts across the report. | Derived |

Schema: https://lossruns.claims/schema.json · Example: https://lossruns.claims/example.json

## What your agent does with it

- **Read the PDF.** A PDF or AL3 file in, a typed LossRun out, from any carrier. `POST /parse`
- **Check the figures.** Every claim ties out: incurred is paid plus reserve. `validate_lossrun`
- **Request a fresh run.** A request letter to the carrier, addressed and ready to send. `draft_lossrun_request`
- **Explain any field.** What a figure means and what moves it after valuation. `explain_lossrun_field`

## Hand it to your agent

Point your agent at the MCP server. The schema, the checks and the request letter become tools.

```json
{ "mcpServers": { "lossruns.claims": { "url": "https://lossruns.claims/mcp" } } }
```

Tools:

- `get_lossrun_schema`: The JSON Schema (2020-12) for the loss run: every field, its type and what it means. Also served at https://lossruns.claims/schema.json.
- `get_lossrun_example`: A complete, valid example LossRun record with fictional values. Also served at https://lossruns.claims/example.json.
- `explain_lossrun_field`: What one field of the loss run means, its type, and where the value comes from. Accepts paths like claims[].incurred.
- `validate_lossrun`: Check a LossRun record against the schema, then run the document's own checks (sums, dates). Returns valid (the shape matches), consistent (every check passes too), errors (schema) and warnings (checks). Nothing is stored.
- `draft_lossrun_request`: Draft a loss-run request letter to the carrier that held the policy, for currently valued runs covering the past N policy years. Returns the subject, the letter text and notes. Nothing is sent; the insured or the agent of record sends it.

## Built to be read by machines

- https://lossruns.claims/llms.txt · https://lossruns.claims/llms-full.txt · https://lossruns.claims/index.md · https://lossruns.claims/index.json
- https://lossruns.claims/schema.json · https://lossruns.claims/example.json · https://lossruns.claims/openapi.json · https://lossruns.claims/mcp
- https://lossruns.claims/.well-known/agents.json · https://lossruns.claims/sitemap.xml · https://lossruns.claims/robots.txt

## Questions

### What is a loss run?

A carrier's report of every claim on a policy for a term, with paid, reserve and incurred, valued as of a stated date. Underwriters ask for one at every renewal.

### How many years do underwriters want?

Usually three to five, valued recently. Open claims move after the valuation date, so markets ask for a fresh run.

### How do I get a loss run?

The insured or the agent of record asks the carrier in writing. Many states set a 10 to 30 day deadline; rules vary. The draft_lossrun_request tool writes the letter.

### Is the schema free?

Yes, with no key: the schema, the example, the checks and the MCP tools. Parsing documents needs an access key.

## Read every loss run as data.

Request an access key for parsing documents. Request access: https://lossruns.claims/#access

---

Nothing on this site is legal or coverage advice. © 2026 lossruns.claims