How to call the IndiaInsurances API: policy clause data guide (2026)

Free REST API and MCP server for clause-level Indian insurance policy data, with the insurer's own words for every fact


Written by the IndiaInsurances team. This is a how-to for our own free API. It is information, not insurance advice; we do not sell insurance.

IndiaInsurances reads Indian insurance policies clause by clause. It lists the products on IRDAI's registers (16,926 products from 78 insurers as of its 21 Oct 2026 data date) and, for the products it has read, returns each fact with the insurer's own words (field quote), the clause and the page. The REST API and MCP server are free, with no key and no sign-up.

The endpoints most builders need

Job Call
Search products by name GET /api/v1/policies?q=
Filter by a stated term GET /api/v1/policies/find?category=&where=
One product, all facts GET /api/v1/policy/{uin}
Search inside a policy's wording GET /api/v1/policy/{uin}/search?q=
Compare products GET /api/v1/compare?uins=
Insurers and their contacts GET /api/v1/insurers, /api/v1/insurer/{slug}/contacts
Complaint path GET /api/v1/complaint-path?insurer=&issue=&state=

Base URL: https://indiainsurances.com. Full spec: openapi.json.

1. Find a product

curl "https://indiainsurances.com/api/v1/policies?q=senior+citizen+health"

Each result has the uin, name, insurer, category, status, an analysis level, the product page url and its api link.

2. Shortlist by a clause value

This finds hospitalisation policies whose documents state a pre-existing-disease waiting period of 24 months or less:

curl "https://indiainsurances.com/api/v1/policies/find?category=health-indemnity&where=ped_waiting<=24"

Each match carries matched.ped_waiting with the display value and the verbatim quote from the policy. The response note matters: a product that does not state a value is left out, not ruled out.

3. Read one policy's facts

curl "https://indiainsurances.com/api/v1/policy/bajhlip23210v042223"

Facts cover waiting periods, limits, co-pay, exclusions, claims and renewal rights. Statuses tell you how far to trust a fact: products read in full were read twice and cross-checked; machine-read products are flagged as such; not-stated means the documents do not say, so do not fill it from memory.

4. Python: compare two policies

import requests
B = "https://indiainsurances.com/api/v1"
uins = "BAJHLIP23210V042223,UNIHLIP21412V022021"
r = requests.get(f"{B}/compare", params={"uins": uins}, timeout=30)
print(r.json())

5. Or add it as an MCP server

https://indiainsurances.com/mcp (Streamable HTTP, read-only, no key):

claude mcp add --transport http indiainsurances https://indiainsurances.com/mcp

Rules for showing results to users

FAQ

Is it free? Yes, REST and MCP, no key, no account.

Is every policy read in full? No. As of the data date, 135 products are read in full, 3,769 more have a first machine reading, and the rest are listed with their documents. Responses say which.

Does it cover life, health and general insurance? Yes: health, term life, savings, ULIPs, pension, motor, travel and more.

Where are the docs? Quickstart and API reference guide.