> ## Documentation Index > Fetch the complete documentation index at: https://docs.stockinsights.ai/llms.txt > Use this file to discover all available pages before exploring further. # Companies List > Returns a paginated list of Indian companies with identifiers (ISIN, BSE, NSE) and industry classification. Supports filtering by ticker, sector, industry, market-cap category, and company ID. Defaults to sort by `company_name` ascending. ## OpenAPI ````yaml openapi-india get /api/in/v0/companies openapi: 3.0.0 info: title: stockinsights.ai APIs description: All the APIs of stockinsights.ai version: 1.0.0 servers: - url: https://stockinsights-ai-main-95a26a0.zuplo.app security: - bearerAuth: [] paths: /api/in/v0/companies: get: summary: Companies List description: >- Returns a paginated list of Indian companies with identifiers (ISIN, BSE, NSE) and industry classification. Supports filtering by ticker, sector, industry, market-cap category, and company ID. Defaults to sort by `company_name` ascending. operationId: getCompanies parameters: - name: ticker in: query description: >- Comma-separated ticker values. Plain tickers (e.g. `RELIANCE`) match the generic stock ticker. Exchange-prefixed values route to the correct exchange: `NSE:TCS` / `NSE.TCS` match the NSE symbol; `BSE:INFY` / `BSE.INFY` match the BSE ticker/ID. Mixed values are supported, e.g. `NSE:TCS,BSE:INFY,RELIANCE`. schema: type: string pattern: ^(large|mid|small|micro|nano)(,(large|mid|small|micro|nano))*$ required: false - name: sector in: query description: >- Comma-separated sectors to filter by (based on Industry Classification). Check valid values in [Company Details](https://drive.google.com/file/d/1oeghBbg6HmW5hl5MDR4CUFZDYYIjJorQ/view). schema: type: string pattern: >- ^((company_name|marketcap_category):(asc|desc))(,((company_name|marketcap_category):(asc|desc)))*$ required: false - name: industry in: query description: >- Comma-separated industries to filter by (based on Industry Classification). Check valid values in [Company Details](https://drive.google.com/file/d/1oeghBbg6HmW5hl5MDR4CUFZDYYIjJorQ/view). schema: type: string required: false - name: company_id in: query description: Comma-separated internal company IDs to filter by. schema: type: string required: false - name: marketcap_category in: query description: >- Comma-separated lowercase market-cap category keys. Client-supported inputs are `large`, `mid`, `small`, `micro`, and `nano`. Current India data returns categories such as `large`, `mid`, `small`, and `micro`. schema: type: string required: false - name: sort in: query description: >- Sort specification as `key:order` pairs, comma-separated. Supported keys: `company_name`, `marketcap_category`. Supported orders: `asc`, `desc`. Example: `company_name:asc` or `marketcap_category:desc,company_name:asc`. schema: type: string required: false - name: page in: query description: Page number for pagination. Defaults to 1. schema: type: integer minimum: 1 required: false - name: limit in: query description: >- Number of results per page. Defaults to 10000 (returns all companies). schema: type: integer minimum: 1 required: false responses: '200': description: Successful response content: application/json: schema: type: object properties: status: type: string enum: - success data: type: array items: $ref: '#/components/schemas/Company' meta: $ref: '#/components/schemas/Meta' '400': description: Invalid request content: application/json: schema: $ref: '#/components/schemas/Error' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/Error' '500': description: Internal server error content: application/json: schema: $ref: '#/components/schemas/Error' components: schemas: Company: type: object description: Represents details of a company properties: id: type: string description: Internal Company ID company_name: type: string description: Company name ticker: type: string nullable: true description: Primary ticker symbol isin: type: string nullable: true description: ISIN code of the company marketcap_category: type: string nullable: true description: >- Lowercase market-cap category key returned by the API, e.g. `large`, `mid`, `small`, `micro`, or `nano` market_snapshot: type: object description: >- Latest market snapshot for Indian companies. Market cap is reported in INR crores and price values are reported in INR. required: - market_cap - prices - as_of properties: market_cap: type: object required: - value - unit properties: value: type: number nullable: true description: Market capitalization in INR crores unit: type: string enum: - INR_CRORE description: Market capitalization unit prices: type: object required: - currency - current - high_52w - low_52w properties: currency: type: string enum: - INR description: Price currency current: type: number nullable: true description: Current market price high_52w: type: number nullable: true description: 52-week high price low_52w: type: number nullable: true description: 52-week low price as_of: type: string format: date-time nullable: true description: Timestamp when the market snapshot was last updated industry_info: $ref: '#/components/schemas/IndustryInfo' exchange_info: type: array description: >- Per-exchange identifiers. For Indian companies this contains entries for BSE and/or NSE. Fields vary by exchange: BSE entries expose `scrip_code`; NSE entries expose `symbol`. items: type: object properties: exchange: type: string enum: - BSE - NSE description: Exchange name scrip_code: type: string nullable: true description: BSE scrip code. Present on BSE entries only. symbol: type: string nullable: true description: NSE trading symbol. Present on NSE entries only. url: type: string nullable: true description: Company page URL on the exchange company_website: type: string nullable: true description: Company website URL Meta: type: object properties: total_count: type: integer format: int64 description: Total Announcemnt count for the given request parameters. page: type: integer format: int64 description: Current Page number. limit: type: integer format: int64 description: Number of Announcements in the current response. Error: type: object properties: errors: type: array items: type: object properties: status: type: string description: Error status title: type: string description: Error description message: type: string description: Detailed error message (optional) IndustryInfo: type: object nullable: true description: Industry classification information properties: macro: type: string nullable: true description: Macro industry classification sector: type: string nullable: true description: Sector classification industry: type: string nullable: true description: Industry classification basic_industry: type: string nullable: true description: Basic industry classification securitySchemes: bearerAuth: type: http scheme: bearer ````