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.
openapi: 3.2.0
info:
title: IndiaCos Doctor API
version: 2.0.0
description: 'Prepaid API (sign up at https://indiacos.com/signup for ₹50 of free credit, then ₹0.40 per successful call; HTTP 402 insufficient_balance when the wallet is empty; agents: https://indiacos.com/auth.md; docs at https://indiacos.com/api/docs) to Indian companies and LLPs (status, capital, registered office, charges, GST filings), GST registrations, PAN lookups, directors, name pages, shared addresses, search and court-case summaries, one record at a time, under the IndiaCos Data Licence (https://indiacos.com/terms#licence): internal business use, commercial included, and showing individual records to your own users are allowed; resale or redistribution of the data, building a competing database and AI training need a written licence (support@indiacos.com). There are no bulk downloads.'
contact:
email: support@indiacos.com
license:
name: IndiaCos Data Licence
url: https://indiacos.com/terms#licence
servers:
- url: https://indiacos.com/api/v1
security:
- bearer: []
- apiKey: []
- oauth:
- api
tags:
- name: Doctor
paths:
/doctor/search:
get:
summary: Doctors on the Indian Medical Register (National Medical Commission) by name…
operationId: searchDoctors
parameters:
- name: q
in: query
schema:
type: string
description: Doctor's name
- name: registration_number
in: query
schema:
type: string
description: Registration number, however written
- name: council
in: query
schema:
type: string
description: State medical council code, e.g. MAH, DEL (see a result or /doctors)
- name: year
in: query
schema:
type: string
description: Year on the register
- name: limit
in: query
schema:
type: integer
minimum: 1
maximum: 100
default: 50
- name: offset
in: query
schema:
type: integer
minimum: 0
maximum: 10000
default: 0
responses:
'200':
description: '{results, limit, offset, has_more, register_complete, order}'
'400':
description: Error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'401':
description: Error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'429':
description: Error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
tags:
- Doctor
/doctor/{id}:
get:
summary: 'One Indian Medical Register entry: name, father''s name, registration number and…'
operationId: getDoctor
parameters:
- name: id
in: path
required: true
schema:
type: string
description: The id from /doctor/search (the number at the end of the page URL)
example: '14198543'
responses:
'200':
description: Register entry
'400':
description: Error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'401':
description: Error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: Error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
tags:
- Doctor
components:
schemas:
Error:
type: object
properties:
error:
type: string
message:
type: string
docs:
type: string
securitySchemes:
bearer:
type: http
scheme: bearer
description: API key of your IndiaCos account (https://indiacos.com/signup)
apiKey:
type: apiKey
in: header
name: X-API-Key
oauth:
type: oauth2
flows:
authorizationCode:
authorizationUrl: https://indiacos.com/oauth/authorize
tokenUrl: https://indiacos.com/oauth/token
refreshUrl: https://indiacos.com/oauth/token
scopes:
api: Use the API, billed to the wallet