IndiaInsurances Registered Agents API

The Registered Agents API from IndiaInsurances — 3 operation(s) for registered agents.

GitHub OpenAPI

Operations 3

GET /api/v1/registered-agents Search verified insurance agents and intermediaries #
GET /api/v1/registered-agents/kinds Types of verified intermediaries, with counts #
GET /api/v1/registered-agents/states States on the firm and surveyor register, with counts #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/indiainsurances-com:indiainsurances-com-registered-agents-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

indiainsurances-com-registered-agents-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: IndiaInsurances Registered Agents API
  version: 1.0.0
  description: The insurance products on the IRDAI registers with their own documents; most of the ones on sale read clause by clause (most by one machine reading, marked so). Each fact carries the verbatim policy para (field `quote`), the clause and page it came from, and a check status; "not-stated" means the documents do not say. Free, no key, 120 requests a minute per IP. Information, not advice.
  contact:
    email: support@indiainsurances.com
    url: https://indiainsurances.com/for-agents
  termsOfService: https://indiainsurances.com/terms
servers:
- url: https://indiainsurances.com
tags:
- name: Registered Agents
paths:
  /api/v1/registered-agents:
    get:
      operationId: searchRegisteredAgents
      summary: Search verified insurance agents and intermediaries
      description: Firms (corporate agents, brokers, TPAs, marketing firms, aggregators, surveyors, repositories) and individual agents, verified by IndiaInsurances. q is a name, CoR, licence number, agent ID or PIN. A licence number is fetched live if we do not hold it yet. kind is a firm slug (corporate-agents, brokers, ...). state is a state slug (tamil-nadu). Without q, returns recent firms plus kinds and counts. Phone and e-mail are stored and returned masked only. A miss is not proof the agent is unregistered.
      parameters:
      - name: q
        in: query
        required: false
        description: Name, CoR, licence number, agent ID or PIN
        schema:
          type: string
      - name: kind
        in: query
        required: false
        description: Firm kind slug, e.g. brokers, corporate-agents
        schema:
          type: string
      - name: state
        in: query
        required: false
        description: State slug, e.g. tamil-nadu
        schema:
          type: string
      - name: limit
        in: query
        required: false
        description: Max 100
        schema:
          type: integer
      responses:
        '200':
          description: Matching firms (agents) and individual appointments (individuals)
          content:
            application/json:
              schema:
                type: object
                properties:
                  agents:
                    type: array
                    items:
                      type: object
                      properties:
                        kind:
                          type: string
                        kind_slug:
                          type: string
                        kind_label:
                          type: string
                        code:
                          type: string
                        slug:
                          type: string
                        name:
                          type: string
                        url:
                          type: string
                        api:
                          type: string
                        category:
                          type:
                          - string
                          - 'null'
                        principal_officer:
                          type:
                          - string
                          - 'null'
                        address:
                          type:
                          - string
                          - 'null'
                        state:
                          type:
                          - string
                          - 'null'
                        state_slug:
                          type:
                          - string
                          - 'null'
                        pincode:
                          type:
                          - string
                          - 'null'
                        website:
                          type:
                          - string
                          - 'null'
                        valid_from:
                          type:
                          - string
                          - 'null'
                        valid_to:
                          type:
                          - string
                          - 'null'
                        status:
                          type: string
                        email_masked:
                          type:
                          - string
                          - 'null'
                        phone_masked:
                          type:
                          - string
                          - 'null'
                        has_email:
                          type: boolean
                        has_phone:
                          type: boolean
                        extra:
                          type:
                          - object
                          - 'null'
                        fetched_at:
                          type: string
                        source_as_of:
                          type:
                          - string
                          - 'null'
                        verified_by:
                          type: string
                        notice:
                          type: string
                  individuals:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        license:
                          type: string
                        name:
                          type: string
                        url:
                          type: string
                        api:
                          type: string
                        urn:
                          type:
                          - string
                          - 'null'
                        agent_id:
                          type:
                          - string
                          - 'null'
                        insurance_type:
                          type:
                          - string
                          - 'null'
                        insurer:
                          type:
                          - string
                          - 'null'
                        dp_id:
                          type:
                          - string
                          - 'null'
                        state:
                          type:
                          - string
                          - 'null'
                        state_slug:
                          type:
                          - string
                          - 'null'
                        district:
                          type:
                          - string
                          - 'null'
                        pincode:
                          type:
                          - string
                          - 'null'
                        valid_from:
                          type:
                          - string
                          - 'null'
                        valid_to:
                          type:
                          - string
                          - 'null'
                        absorbed:
                          type:
                          - boolean
                          - 'null'
                        status:
                          type: string
                        phone_masked:
                          type:
                          - string
                          - 'null'
                        mobile_masked:
                          type:
                          - string
                          - 'null'
                        has_phone:
                          type: boolean
                        has_mobile:
                          type: boolean
                        fetched_at:
                          type: string
                        verified_by:
                          type: string
                        notice:
                          type: string
                  kinds:
                    type: array
                    items:
                      type: object
                      properties:
                        slug:
                          type: string
                        key:
                          type: string
                        label:
                          type: string
                        n:
                          type: integer
                  counts:
                    type: object
                    properties:
                      firms:
                        type: integer
                      individual_licenses:
                        type: integer
                      individual_appointments:
                        type: integer
                  notice:
                    type: string
        '400':
          description: Bad or missing parameter (see error and message)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: More than 120 requests a minute from this address
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - Registered Agents
  /api/v1/registered-agents/kinds:
    get:
      operationId: listRegisteredAgentKinds
      summary: Types of verified intermediaries, with counts
      responses:
        '200':
          description: Kinds
          content:
            application/json:
              schema:
                type: object
                properties:
                  kinds:
                    type: array
                    items:
                      type: object
                      properties:
                        slug:
                          type: string
                        key:
                          type: string
                        label:
                          type: string
                        n:
                          type: integer
                        url:
                          type: string
                        api:
                          type: string
                  notice:
                    type: string
        '429':
          description: More than 120 requests a minute from this address
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - Registered Agents
  /api/v1/registered-agents/states:
    get:
      operationId: listRegisteredAgentStates
      summary: States on the firm and surveyor register, with counts
      responses:
        '200':
          description: States
          content:
            application/json:
              schema:
                type: object
                properties:
                  states:
                    type: array
                    items:
                      type: object
                      properties:
                        slug:
                          type: string
                        name:
                          type: string
                        n:
                          type: integer
                        url:
                          type: string
                        api:
                          type: string
                  notice:
                    type: string
        '429':
          description: More than 120 requests a minute from this address
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - Registered Agents
components:
  schemas:
    Error:
      type: object
      properties:
        error:
          type: string
        message:
          type: string
        docs:
          type: string