PerfectParser Docs
User GuidesParser Setup Guides

Insurance Policy Parser Setup Guide

Step-by-step dashboard guide to configure an insurance policy parser, define fields, run bulk extraction, and export results.

Before You Start

Before setting up your parser, ensure you have:

  1. A PerfectParser account (sign up at perfectparser.com).
  2. A healthy credit balance (each policy page processed consumes 1 credit).
  3. A sample insurance policy declaration (PDF, PNG, or JPEG) to use during the parser setup.

When creating a new Insurance Policy Parser, choose the document organization structure that matches your files:

  • Single Document Per File: Select this option if each uploaded file represents exactly one policy schedule (even if it spans 20+ pages of detailed plan text).
  • One Document Per Page: This option is not recommended for insurance policies since declarations require cohesive multi-page verification.

We suggest configuring the following schema fields for your Insurance Policy Parser to capture all essential policy declarations.

Field NameTypeDescription
policy_numberTextThe unique policy number or identifier.
insurerTextThe insurance company name (e.g. Geico, Aetna, Allianz).
insured_partyTextThe full name of the policyholder or insured business.
policy_periodTextThe coverage dates range (e.g. June 1, 2026 to May 31, 2027).
coverage_limitNumberThe overall maximum coverage limit of the policy.
deductibleNumberThe deductible or out-of-pocket amount.
premiumNumberThe total premium amount or cost of the policy.
coveragesTableTable containing coverage_type, limit_amount, and deductible details for each category.

AI Instructions (Optional)

To help the AI parser extract field values with maximum accuracy, copy and paste the following prompt instructions into the AI Instructions (Optional) field during setup:

Extract the policy number, insurer name, insured party/business name, policy period coverage dates, total coverage limit, deductible amount, and premium cost. Also extract the coverages table containing coverage type, specific limit amount, and individual deductible.

Step-by-Step UI Setup

Follow these steps to set up your Insurance Policy Parser using the single-page setup in the PerfectParser dashboard.

Step 1: Create the Parser

Log in to your dashboard, click Parsers in the left-hand navigation menu, and click the New Parser button.

Step 2: Configure Name and File Organization

In the Parser Details & Setup section:

  1. Enter a clear, recognizable name in the Parser Name field (e.g., "Insurance Policies").
  2. Choose your document structure under How are your files organized? (e.g., select Single Document Per File).

Step 3: Upload your Sample Policy

Upload your sample document by dragging and dropping it into the upload box on the left-hand Sample Document Preview panel, or clicking the box to choose a file from your computer.

Uploading a sample policy in the New Parser screen

Step 4: Run Auto-Detection

Once the document finishes uploading:

  1. Copy the prompt from the AI Instructions (Optional) section above and paste it into the AI Instructions (Optional) box.
  2. Click the Auto-Detect Fields button. The AI will analyze the sample document's layout and suggest extraction fields within 10 to 15 seconds.

Step 5: Verify and Refine Fields

Review the generated schema on the right. You can rename fields, change data types, or edit the helper descriptions to guide extraction. When you are satisfied with the schema, click Create Parser at the bottom right.

Reviewing and configuring detected fields in the parser schema editor

Step 6: Run a Batch Extraction

To process your insurance files:

  1. Click Bulk Extraction in the left sidebar or the top header.
  2. Select your newly created Insurance Policies parser.
  3. Upload one or more policy schedules. PerfectParser will start extracting data immediately.

Starting a new bulk extraction batch

Step 7: Export Extracted Data

Navigate to Batch History in the left sidebar or click the Batch History tab on the parser details page. Click Show Files to inspect individual policy extractions, view confidence scores, and verify the structured output.

Viewing files and inspecting confidence in Batch History

To download your structured data:

  1. Click the Export button on the completed batch card.
  2. Select Export as Excel or Export as CSV from the dropdown menu to download the structured table directly to your computer.

Exporting the structured extraction results to Excel or CSV


Developer Integration

If you want to automate insurance policy parsing programmatically inside your applications:

Looking for product features and use cases?

See the Insurance Policy Data Extraction solution page.