---
title: "Companies and LLPs filtered by category, place, status, kind, incorporation date and capital, newest first. Registered email on keys with contact access."
method: GET
path: "/companies"
---

# Companies and LLPs filtered by category, place, status, kind, incorporation date and capital, newest first. Registered email on keys with contact access.

`GET /companies`

## Request

- Base URL: `https://indiacos.com/api/v1`
- URL: `https://indiacos.com/api/v1/companies`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`
  - OAuth 2 (authorization code, authorization URL `https://indiacos.com/oauth/authorize`, token URL `https://indiacos.com/oauth/token`, scopes: `api`)

## Query parameters

- `category` string
- `nic` string
- `state` string
- `district` string
- `status` string
- `kind` string
- `incorporated_from` string
- `incorporated_to` string
- `min_paid_capital` integer
- `max_paid_capital` integer
- `has_email` boolean
- `limit` integer
- `offset` integer

## Response `200`

List

- CompanyList
  - `count` integer
  - `limit` integer
  - `offset` integer
  - `next` string, nullable
  - `results` object[]
    - `cin` string
    - `type` string
    - `name` string
    - `category` string, nullable
    - `category_name` string, nullable
    - `status` string
    - `state` string, nullable
    - `incorporation_date` string, nullable
    - `paid_up_capital` integer, nullable
    - `email` string, nullable: Only on keys with contact access
    - `url` string

## Other responses

- `400`: Error
- `401`: Error
- `403`: Error
- `429`: Error

---

[API](https://skmtc.dev/indiacos/apis/indiacos-api.md) · [All operations](https://skmtc.dev/indiacos/apis/indiacos-api/llms.txt) · [OpenAPI document](https://skmtc.dev/indiacos/apis/indiacos-api/revisions/c5e9ea2b1dc4?raw)