{
  "name": "acords.co",
  "url": "https://acords.co/",
  "title": "acords.co: loss-notice data fields as a typed model for agents",
  "description": "An independent reference to the data fields on the industry-standard insurance forms, starting with the loss notice that opens every claim. A free typed field model, checks and an MCP server for agents. Not affiliated with ACORD Corporation.",
  "document": {
    "name": "Loss notice",
    "schema": "LossNotice",
    "definition": "The industry files claims and proves coverage on standard forms. The fields, not the paper, are what an agent needs typed.",
    "facts": [
      {
        "label": "The family",
        "value": "Three loss notices and a certificate, with fields in common."
      },
      {
        "label": "Published by",
        "value": "ACORD, the industry's standards body. This site is independent."
      },
      {
        "label": "Filled by",
        "value": "Agents, brokers and insureds at first notice of loss."
      },
      {
        "label": "Sent to",
        "value": "The carrier's claim intake, where the claim's clocks start."
      },
      {
        "label": "On this page",
        "value": "An original layout with fictional values, not an ACORD form."
      }
    ]
  },
  "fields": [
    {
      "field": "form",
      "type": "property | auto | liability",
      "meaning": "The notice family.",
      "source": "Agent intake"
    },
    {
      "field": "reported_at",
      "type": "date-time",
      "meaning": "When it was filed. The claim's clocks start here.",
      "source": "Agent intake"
    },
    {
      "field": "reported_by",
      "type": "string",
      "meaning": "The insured, the agent of record or a broker.",
      "source": "Agent intake"
    },
    {
      "field": "carrier",
      "type": "string",
      "meaning": "The carrier the notice is addressed to.",
      "source": "Policy record"
    },
    {
      "field": "policy_number",
      "type": "string",
      "meaning": "The policy the loss is claimed under.",
      "source": "Policy record"
    },
    {
      "field": "term_start · term_end",
      "type": "date",
      "meaning": "Policy period: the loss date should fall inside.",
      "source": "Policy record"
    },
    {
      "field": "named_insured",
      "type": "string",
      "meaning": "Named insured on the policy.",
      "source": "Policy record"
    },
    {
      "field": "contact",
      "type": "object",
      "meaning": "Who the adjuster should reach, and how.",
      "source": "Agent intake"
    },
    {
      "field": "date_of_loss · time_of_loss",
      "type": "date · time",
      "meaning": "When it happened, as precisely as known.",
      "source": "Insured's report"
    },
    {
      "field": "loss_type",
      "type": "string",
      "meaning": "Peril: wind_hail, fire, water, collision, theft, liability.",
      "source": "Insured's report"
    },
    {
      "field": "loss_location",
      "type": "string",
      "meaning": "Where it happened.",
      "source": "Insured's report"
    },
    {
      "field": "description",
      "type": "text",
      "meaning": "A plain account of the loss, injuries noted.",
      "source": "Insured's report"
    },
    {
      "field": "authorities_contacted",
      "type": "string",
      "meaning": "Police or fire report, if any.",
      "source": "Insured's report"
    },
    {
      "field": "remarks",
      "type": "text",
      "meaning": "Anything material that fits no field.",
      "source": "Agent intake"
    }
  ],
  "verbs": [
    {
      "verb": "parse",
      "title": "Read a filed notice",
      "does": "A completed notice in, typed fields out, whichever form it came on.",
      "call": "POST /parse",
      "access_key": true
    },
    {
      "verb": "prefill",
      "title": "Draft the notice",
      "does": "Intake answers in, a typed notice and the questions left out.",
      "call": "prefill_loss_notice",
      "access_key": false
    },
    {
      "verb": "check",
      "title": "Check before filing",
      "does": "Loss inside the term, dates in order, a contact who can be reached.",
      "call": "validate_loss_notice",
      "access_key": false
    },
    {
      "verb": "explain",
      "title": "Explain any field",
      "does": "What a field means, who supplies it and what depends on it.",
      "call": "explain_loss_notice_field",
      "access_key": false
    }
  ],
  "mcp": {
    "url": "https://acords.co/mcp",
    "transport": "streamable-http",
    "tools": [
      {
        "name": "get_loss_notice_schema",
        "description": "The JSON Schema (2020-12) for the loss notice: every field, its type and what it means. Also served at https://acords.co/schema.json."
      },
      {
        "name": "get_loss_notice_example",
        "description": "A complete, valid example LossNotice record with fictional values. Also served at https://acords.co/example.json."
      },
      {
        "name": "explain_loss_notice_field",
        "description": "What one field of the loss notice means, its type, and where the value comes from. Accepts paths like authorities_contacted."
      },
      {
        "name": "validate_loss_notice",
        "description": "Check a LossNotice 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."
      },
      {
        "name": "prefill_loss_notice",
        "description": "Turn the fields gathered at intake into a typed LossNotice: loss_type and dates normalized, the form family inferred from the peril, and every required field still missing listed with the question to ask for it. Nothing is invented and nothing is filed."
      }
    ]
  },
  "faq": [
    {
      "q": "What is a first notice of loss?",
      "a": "The first report of a loss to the carrier. It opens the claim file and starts its clocks: who reported, under which policy, what happened, where and when."
    },
    {
      "q": "Which ACORD forms are loss notices?",
      "a": "ACORD 1, 2 and 3: property, auto and general liability. The ACORD 25 is the certificate of liability insurance, a different form."
    },
    {
      "q": "Is acords.co affiliated with ACORD?",
      "a": "No. It is an independent reference to the fields those forms carry, and the notice shown here is an original layout."
    },
    {
      "q": "Is the field model free?",
      "a": "Yes, with no key: the model, the example, the checks and prefill. Parsing filed notices needs an access key."
    }
  ],
  "links": {
    "schema": "https://acords.co/schema.json",
    "example": "https://acords.co/example.json",
    "openapi": "https://acords.co/openapi.json",
    "llms": "https://acords.co/llms.txt",
    "llms_full": "https://acords.co/llms-full.txt",
    "markdown": "https://acords.co/index.md",
    "agents": "https://acords.co/.well-known/agents.json",
    "sitemap": "https://acords.co/sitemap.xml",
    "request_access": "https://acords.co/#access"
  },
  "family": [
    {
      "url": "https://api.insure",
      "what": "the insurance industry as one agent-first API"
    },
    {
      "url": "https://gigs.claims",
      "what": "flat-fee claim files for licensed adjusters"
    },
    {
      "url": "https://lossruns.claims",
      "what": "the loss run as typed data"
    },
    {
      "url": "https://eobs.claims",
      "what": "the Explanation of Benefits as typed data"
    }
  ],
  "updated": "2026-10-09"
}