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 Copyright 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: Copyright
paths:
/copyright/{roc_number}:
get:
summary: 'One work in the Register of Copyrights (Copyright Office of India): ROC date…'
operationId: getCopyright
parameters:
- name: roc_number
in: path
required: true
schema:
type: string
description: 'ROC number, slash as a dash: L-100000-2021 (L-100000/2021 URL-encoded also works)'
example: L-100000-2021
responses:
'200':
description: Registered work
'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:
- Copyright
/copyright/search:
get:
summary: Registered works by words of the title, applicant or author, category, ROC year…
operationId: searchCopyrights
parameters:
- name: q
in: query
schema:
type: string
description: Words of the title, applicant or author
- name: category
in: query
schema:
type: string
description: literary, artistic, software, sound-recordings, films or music
- name: year
in: query
schema:
type: integer
description: Year of the ROC number
- name: cin
in: query
schema:
type: string
description: CIN or LLPIN of the applicant company
- 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, 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:
- Copyright
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