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
- Cite the product page and clause link for every fact you repeat.
- Never tell a user a claim will be paid; point to the clause and the insurer.
- For grievances, the complaint path and Ombudsman pages and the API's
complaint-pathcall give each insurer's contacts with sources.
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.