Search verified auto insurance policies, home insurance policies, and auto ID cards from major insurance carriers without the need for login credentials using Canopy Connect's Policy Search API.
Search Types
The Policy Search API supports three credential-less search types.
| Search Type | Description |
|---|---|
| Auto ID Card Search | Search for an Auto ID Card |
| Auto Insurance Policy Search | Search for an Auto insurance policy |
| Home Insurance Policy Search | Search for a Home insurance policy |
Auto ID Card Search
Auto ID Card Search returns verified Auto ID Card info without the need for login credentials.
Carrier-specific Search Input and Output
| Allstate | Farmers | Nationwide | Auto-Owners | |
|---|---|---|---|---|
| Inputs | ||||
| Policy Number | Option A | Option A | Required | |
| Zip | Required | Required | Required | |
| First Name | Required | Option B | ||
| Last Name | Required | Option B | ||
| Date of Birth | Option B | Required | ||
| Email address | Required | |||
| Mobile number | Required | Required | Option B | |
| Mobile OTP (one-time password) | Required | Required | Option B | |
| Outputs | ||||
| Auto ID Card PDF | ✅ | ✅ | ✅ | ✅ |
| Insurance company name | ✅ | ✅ | ✅ | ✅ |
| Insurance company address | ✅ | ✅ | ✅ | Partial (City, State) |
| Policy Status | ✅ | ✅ | ✅ | ✅ |
| Policy Effective Date | ✅ | ✅ | ✅ | ✅ |
| Policy Expiry Date | ✅ | ✅ | ✅ | |
| Policy Number | ✅ | ✅ | ✅ | ✅ |
| Vehicle Details | ✅ | ✅ | ✅ | ✅ |
| Named Insured | ✅ | ✅ | ✅ | ✅ |
| Named Insured Address | Partial (State) | ✅ | Partial (State) | Partial (State) |
| Agent full name | ✅ | ✅ | ✅ | |
| Agent phone | ✅ | ✅ | ✅ | ✅ |
| Agent address | ✅ | ✅ |
Example Auto ID Card Search Result
Fetch the Auto ID Card data via the GET /pulls/:pullId endpoint
{
"success": true,
"pull": {
"answers": [],
"first_name": "Clark",
"middle_name": "J",
"last_name": "Kent",
"work_phone": null,
"work_phone_extension": null,
"mobile_phone": "8885550000",
"home_phone": null,
"gender": null,
"marital_status": null,
"education": null,
"occupation": null,
"email": "[email protected]",
"account_email": "[email protected]",
"phone": null,
"pull_id": "b8ae87fc-9dec-4e85-8eb0-74f9d7b004ac",
"status": "SUCCESS",
"insurance_provider_name": "allstate",
"team_id": "e0e8deb1-6806-4c71-8a69-93c07bd698e5",
"widget_id": "9e1a5a8a-7d96-47c8-bb55-df6be2a4f924",
"is_archived": false,
"created_at": "2025-07-06T00:07:17.813Z",
"no_policies": false,
"no_documents": false,
"no_claims": false,
"no_loss_events": false,
"policies_selection_enabled": false,
"type": "POLICY_LOOKUP",
"skipped_product_types": null,
"insurance_type_selection": null,
"meta_data": null,
"insurance_provider_friendly_name": "Allstate",
"no_drivers": false,
"account_identifier": null,
"public_alias": "demo",
"deleted_at": null,
"public_url": "https://app.usecanopy.com/c/demo",
"encountered_mfa": true,
"funnel": null,
"policies": [
{
"policy_id": "6c35d0f0-0e72-4138-bc16-8272b1c0e3e5",
"name": "AUTO # 123456789",
"description": "Effective 02/16/2025 - 08/16/2025",
"carrier_policy_number": "123456789",
"policy_type": "AUTO",
"effective_date": "2025-03-16T07:00:00.000Z",
"expiry_date": "2025-09-16T07:00:00.000Z",
"renewal_date": "2025-09-16T07:00:00.000Z",
"canceled_date": null,
"total_premium_cents": null,
"carrier_name": "allstate",
"status": "ACTIVE",
"limited_access": false,
"form_of_business": null,
"deductible_cents": null,
"paid_in_full": null,
"amount_due_cents": null,
"amount_paid_cents": null,
"is_selected": false,
"total_estimated_annual_premium_cents": null,
"total_minimum_premium_cents": null,
"total_deposit_premium_cents": null,
"carrier_friendly_name": "Allstate",
"is_monoline": true,
"dwellings": [],
"locations": [],
"vehicles": [
{
"vehicle_id": "25ff9b6c-75c6-4369-b6b6-a1140294cf23",
"year": 2021,
"make": "KIA",
"model": "Telluride",
"series": "EX",
"series2": "Wagon body style",
"type": "MULTIPURPOSE PASSENGER VEHICLE (MPV)",
"annual_mileage": null,
"vin": "1ABC2DEF3GH456789",
"hin": null,
"serial_number": null,
"uses": null,
"purchase_date": null,
"ownership_type": null,
"features": null,
"is_removed": false,
"data_source": "CARRIER",
"lien_holder": null,
"garaging_address": null,
"lien_holder_address": null,
"coverages": [],
"drivers": [
{
"first_name": "Lois",
"middle_name": "",
"last_name": "Lane",
"drivers_license": null,
"date_of_birth_str": null,
"gender": null,
"marital_status": null,
"age": null,
"age_on_date": null,
"education": null,
"occupation": null,
"age_licensed": null,
"data_source": "CARRIER",
"driver_id": "90d0fda0-9ea5-4a58-9dee-a46a3099823b",
"is_excluded": false
},
{
"first_name": "Clark",
"middle_name": "J",
"last_name": "Kent",
"drivers_license": null,
"date_of_birth_str": null,
"gender": null,
"marital_status": null,
"age": null,
"age_on_date": null,
"education": null,
"occupation": null,
"age_licensed": null,
"data_source": "CARRIER",
"driver_id": "d880d5e2-7887-4ab9-8890-787d7e414d2e",
"is_excluded": false
}
],
"GaragingAddress": null,
"LienHolderAddress": null
}
],
"commercial_named_insureds": [],
"named_insureds": [
{
"named_insured_id": "d982455d-e40b-4d4e-abf5-c69ca9882f58",
"first_name": "Clark",
"middle_name": "J",
"last_name": "Kent",
"full_name": "Clark J Kent",
"is_primary_named_insured": null
},
{
"named_insured_id": "8fc4ebdd-101b-4e1d-b74c-3119962c2b4f",
"first_name": "Lois",
"middle_name": "",
"last_name": "Lane",
"full_name": "Lois Lane",
"is_primary_named_insured": null
}
],
"transactions": [],
"notices": [],
"billing_accounts": [],
"payments": []
}
],
"drivers": [
{
"first_name": "Clark",
"middle_name": "J",
"last_name": "Kent",
"drivers_license": null,
"date_of_birth_str": null,
"gender": null,
"marital_status": null,
"age": null,
"age_on_date": null,
"education": null,
"occupation": null,
"age_licensed": null,
"data_source": "CARRIER",
"driver_id": "d880d5e2-7887-4ab9-8890-787d7e414d2e"
},
{
"first_name": "Lois",
"middle_name": "",
"last_name": "Lane",
"drivers_license": null,
"date_of_birth_str": null,
"gender": null,
"marital_status": null,
"age": null,
"age_on_date": null,
"education": null,
"occupation": null,
"age_licensed": null,
"data_source": "CARRIER",
"driver_id": "90d0fda0-9ea5-4a58-9dee-a46a3099823b"
}
],
"documents": [
{
"document_id": "1ee25a42-ee85-484e-b2d7-07530cb89eda",
"title": "07-05-2025 - AUTO # 123456789 - Insurance ID Card",
"date_added": null,
"document_type": "INSURANCE_ID_CARD",
"policy_id": null,
"document_source": "CARRIER",
"document_parsing_result": null,
"document_parsing_error_message": null,
"parser_id": null,
"policy_transaction_id": null,
"policy_notice_id": null
}
],
"addresses": [],
"claims": [],
"driving_records": [],
"loss_events": [],
"agents": [],
"non_policy_linked_data": {
"dwellings": [],
"vehicles": []
}
}
}Auto Insurance Policy Search
Auto Insurance Policy Search returns verified auto insurance policy information without the need for login credentials.
Carrier-specific Search Input and Output
| Progressive | USAA | American Family | |
|---|---|---|---|
| Inputs | |||
| Policy Number | Option A | First 9 digits (”USAA number”) | Required |
| VIN (partial) | Option A (last 6 digits) | Required (last 5 digits) | |
| VIN (full) | Option B | Required | |
| Last Name | Required | ||
| Outputs | |||
| Declarations Page PDF | ✅ | Verification of Insurance PDF | |
| Insurance company name | ✅ | ✅ | ✅ |
| Insurance company address | ✅ | ||
| Policy Status | ✅ | ✅ | ✅ |
| Policy Effective Date | ✅ | ✅ | ✅ |
| Policy Expiry Date | ✅ | ✅ | ✅ |
| Policy Number | ✅ | ✅ | ✅ |
| Vehicle Details | ✅ | ✅ | ✅ |
| Vehicle Coverages | Bodily Injury, Property Damage, Comprehensive, Collision | Collision and Comprehensive deductibles | ✅ |
| Lienholder name | ✅ | ✅ | ✅ |
| Lienholder address | ✅ | ✅ | ✅ |
| Named Insured | ✅ | ✅ | ✅ |
| Named Insured Address | ✅ | ✅ | ✅ |
| Agent full name | ✅ | ✅ | |
| Agent phone | ✅ | ✅ | |
| Agent address | ✅ |
Example Auto Policy Search Result
Fetch the auto insurance policy data via the GET /pulls/:pullId endpoint
{
"success": true,
"pull": {
"answers": [],
"first_name": "Clark",
"middle_name": "J",
"last_name": "Kent",
"work_phone": null,
"work_phone_extension": null,
"mobile_phone": null,
"home_phone": null,
"gender": null,
"marital_status": null,
"education": null,
"occupation": null,
"email": null,
"account_email": null,
"phone": null,
"pull_id": "85fe68d4-8da1-472a-b34d-db9a662ec2fa",
"status": "SUCCESS",
"insurance_provider_name": "progressive",
"team_id": "0f902ea1-908f-4893-839f-fb4ee3501645",
"widget_id": "cc1acb96-78e7-4a21-8311-115730543c59",
"is_archived": false,
"created_at": "2025-06-27T15:24:48.749Z",
"no_policies": false,
"no_documents": false,
"no_claims": false,
"no_loss_events": false,
"policies_selection_enabled": false,
"type": "POLICY_LOOKUP",
"skipped_product_types": null,
"insurance_type_selection": null,
"meta_data": null,
"insurance_provider_friendly_name": "Progressive",
"no_drivers": false,
"account_identifier": null,
"public_alias": "demo",
"deleted_at": null,
"public_url": "https://app.usecanopy.com/c/demo",
"encountered_mfa": false,
"funnel": null,
"policies": [
{
"policy_id": "55cd2c6e-4666-4549-96b3-24f58724663e",
"name": "AUTO # 123456789",
"description": "Effective 06/22/2025 - 12/22/2025",
"carrier_policy_number": "123456789",
"policy_type": "AUTO",
"effective_date": "2025-06-22T06:00:00.000Z",
"expiry_date": "2025-12-22T07:00:00.000Z",
"renewal_date": "2025-12-22T07:00:00.000Z",
"canceled_date": null,
"total_premium_cents": null,
"carrier_name": "progressive",
"status": "ACTIVE",
"limited_access": false,
"form_of_business": null,
"deductible_cents": null,
"paid_in_full": null,
"amount_due_cents": null,
"amount_paid_cents": null,
"is_selected": false,
"total_estimated_annual_premium_cents": null,
"total_minimum_premium_cents": null,
"total_deposit_premium_cents": null,
"carrier_friendly_name": "Progressive",
"is_monoline": true,
"dwellings": [],
"locations": [],
"vehicles": [
{
"vehicle_id": "c4c443ed-1799-4074-b868-cbdc5a297704",
"year": 2018,
"make": "CHEVROLET",
"model": "Camaro",
"series": "ZL1",
"series2": null,
"type": "PASSENGER CAR",
"annual_mileage": null,
"vin": "1ABC2DEF3GH456789",
"hin": null,
"serial_number": null,
"uses": null,
"purchase_date": null,
"ownership_type": null,
"features": null,
"is_removed": false,
"data_source": "CARRIER",
"lien_holder": null,
"garaging_address": null,
"lien_holder_address": null,
"coverages": [
{
"vehicle_coverage_id": "673d7cdd-49d3-4290-aa53-178353009703",
"name": "BODILY_INJURY_LIABILITY",
"friendly_name": "Bodily Injury Liability",
"premium_cents": null,
"per_person_limit_cents": 5000000,
"per_person_unlimited": false,
"per_incident_limit_cents": 10000000,
"per_incident_unlimited": false,
"per_day_limit_cents": null,
"deductible_cents": null,
"actual_cash_value": false,
"is_declined": false,
"per_mile_premium_tenth_of_cents": null,
"max_days": null
},
{
"vehicle_coverage_id": "ccd6f609-5f8a-47db-a4e0-a4cb7ba4072af",
"name": "PROPERTY_DAMAGE_LIABILITY",
"friendly_name": "Property Damage Liability",
"premium_cents": null,
"per_person_limit_cents": null,
"per_person_unlimited": false,
"per_incident_limit_cents": 5000000,
"per_incident_unlimited": false,
"per_day_limit_cents": null,
"deductible_cents": null,
"actual_cash_value": false,
"is_declined": false,
"per_mile_premium_tenth_of_cents": null,
"max_days": null
},
{
"vehicle_coverage_id": "02f4f81e-78e0-4c49-a668-d614db360b1d",
"name": "COLLISION",
"friendly_name": "Collision",
"premium_cents": null,
"per_person_limit_cents": null,
"per_person_unlimited": false,
"per_incident_limit_cents": null,
"per_incident_unlimited": false,
"per_day_limit_cents": null,
"deductible_cents": 150000,
"actual_cash_value": false,
"is_declined": false,
"per_mile_premium_tenth_of_cents": null,
"max_days": null
},
{
"vehicle_coverage_id": "17d232e5-81e8-4e02-b96f-87a0501c36e1",
"name": "COMPREHENSIVE",
"friendly_name": "Comprehensive",
"premium_cents": null,
"per_person_limit_cents": null,
"per_person_unlimited": false,
"per_incident_limit_cents": null,
"per_incident_unlimited": false,
"per_day_limit_cents": null,
"deductible_cents": 100000,
"actual_cash_value": false,
"is_declined": false,
"per_mile_premium_tenth_of_cents": null,
"max_days": null
}
],
"drivers": [
{
"first_name": "Clark",
"middle_name": "J",
"last_name": "Kent",
"drivers_license": null,
"date_of_birth_str": null,
"gender": null,
"marital_status": null,
"age": null,
"age_on_date": null,
"education": null,
"occupation": null,
"age_licensed": null,
"data_source": "CARRIER",
"driver_id": "9632b541-e755-4c99-9a2d-5b04bcb0829b",
"is_excluded": false
},
{
"first_name": "Lois",
"middle_name": "",
"last_name": "Lane",
"drivers_license": null,
"date_of_birth_str": null,
"gender": null,
"marital_status": null,
"age": null,
"age_on_date": null,
"education": null,
"occupation": null,
"age_licensed": null,
"data_source": "CARRIER",
"driver_id": "43077ae8-7a68-45c0-b267-0c3151ebcf2f",
"is_excluded": false
}
],
"GaragingAddress": null,
"LienHolderAddress": null
}
],
"commercial_named_insureds": [],
"named_insureds": [
{
"named_insured_id": "c9d1bacf-701d-42f6-a728-385db7f7268e",
"first_name": "Clark",
"middle_name": "J",
"last_name": "Kent",
"full_name": null,
"is_primary_named_insured": true
}
],
"forms_and_endorsements": [],
"transactions": [],
"notices": [],
"billing_accounts": [],
"payments": [],
"policy_check": {
"status": "NONE",
"details": {}
}
}
],
"drivers": [
{
"first_name": "Clark",
"middle_name": "J",
"last_name": "Kent",
"drivers_license": null,
"date_of_birth_str": null,
"gender": null,
"marital_status": null,
"age": null,
"age_on_date": null,
"education": null,
"occupation": null,
"age_licensed": null,
"data_source": "CARRIER",
"driver_id": "9632b541-e755-4c99-9a2d-5b04bcb0829b"
},
{
"first_name": "Lois",
"middle_name": "",
"last_name": "Lane",
"drivers_license": null,
"date_of_birth_str": null,
"gender": null,
"marital_status": null,
"age": null,
"age_on_date": null,
"education": null,
"occupation": null,
"age_licensed": null,
"data_source": "CARRIER",
"driver_id": "43077ae8-7a68-45c0-b267-0c3151ebcf2f"
}
],
"documents": [],
"addresses": [],
"claims": [],
"driving_records": [],
"loss_events": [],
"agents": [
{
"agent_info_id": "b7ca38c9-a97d-4562-8a3b-5e88c50195e4",
"address_id": null,
"agency_name": null,
"agent_full_name": "Progressive",
"phone_number": "8001234567",
"email": null,
"agent_code": null,
"policy_ids": [
"55cd2c6e-4666-4549-96b3-24f58724663e"
]
}
],
"non_policy_linked_data": {
"dwellings": [],
"vehicles": []
},
"policy_check_status": "NONE"
}
}Home Insurance Policy Search
Home insurance policy search returns verified home insurance policy information without the need for login credentials.
Carrier-specific Search Input and Output
| USAA | American Family | Liberty Mutual | |
|---|---|---|---|
| Inputs | |||
| Policy Number | Required | Required | Required |
| Hurricane Policy Number | Optional | ||
| Property Address | Required | ||
| House Number | Required | ||
| Zip | Required | Required | |
| First Named Insured - First Name | Required | ||
| First Named Insured - Last Name | Required | ||
| Second Named Insured - First Name | If exists | ||
| Second Named Insured - Last Name | If exists | ||
| First Mortgagee Name | Required | ||
| First Mortgagee Name Line 2 | Required | ||
| Address | Required | ||
| City | Required | ||
| State | Required | ||
| Zip | Required | ||
| Outputs | |||
| Meets Fannie Mae Requirements | ✅ | ✅ | ✅ |
| Named insured | ✅ | ✅ | ✅ |
| Property Address | ✅ | ✅ | ✅ |
| Insurance Company Name | ✅ | ✅ | ✅ |
| Insurance Company Address | ✅ | ✅ | |
| Insurance Contact Email | ✅ | ✅ | |
| Insurance Contact Phone | ✅ | ✅ | |
| Policy Number | ✅ | ✅ | ✅ |
| Policy Type (HO6, HO3, DP3, etc) | ✅ | ✅ | |
| Effective Date | ✅ | ✅ | ✅ |
| Expiration Date | ✅ | ✅ | ✅ |
| Policy premium | ✅ | ✅ | ✅ |
| Total Amount Paid | ✅ | ✅ | ✅ |
| Total Amount Due | ✅ | ✅ | ✅ |
| Dwelling coverage | ✅ | ✅ | ✅ |
| Extended dwelling coverage (if applicable) | ✅ | ✅ | |
| Settlement basis | Only if extended dwelling coverage is present, otherwise unknown | ✅ | |
| Standard extended coverage endorsement | ✅ | ||
| Roof materials settlement basis | ✅ | ||
| Building ordinance coverage (yes or no) | ✅ | ✅ | |
| Deductible amount | ✅ | ✅ | ✅ |
| Wind-loss deductible (if noted separately) | ✅ | ✅ | ✅ |
| First Mortgagee | ✅ | ✅ | ✅ |
| Second Mortgagee, for HELOCs (if needed) | ✅ | ✅ | ✅ |
Data Return
After you initiate an insurance policy search, you can access the result from the Dashboard or API.
- View submissions on the Dashboard
- Fetch the insurance policy data via the GET /pulls/:pullId endpoint