# Company logos API

> Logos and details for companies listed on NSE and BSE.

Put a ticker in the URL and get the logo back as SVG or PNG. A symbol can be a ticker (TCS), an exchange-qualified ticker (NSE:TCS, NSE_TCS), a Yahoo Finance symbol (TCS.NS, AAIL.BO) or an ISIN. A bare ticker prefers NSE.

Base URL `https://api.dharun.dev`. No API key. Answers are JSON, `{ "data": ..., "meta": { ... } }`, and errors are `{ "error": { "code", "message" } }` with a matching HTTP status. Rate limit: 600 requests a minute per client.

## Logo image for a listed company

`GET /v1/logos/{symbol}`

Returns the image itself, ready for an <img> tag. Unknown symbols return 404 unless fallback=monogram is set.

Parameters:

- `symbol` (path, required): Ticker, exchange-qualified ticker, Yahoo symbol or ISIN. A .svg or .png suffix selects the format.
- `format` (query): Image format. Default svg. One of: svg, png.
- `size` (query): PNG width and height in pixels, 16 to 512. Default 128.
- `fallback` (query): Return an initials tile instead of 404 for unknown symbols. One of: monogram.
- `exchange` (query): Force an exchange. One of: nse, bse.

Example: https://api.dharun.dev/v1/logos/TCS (returns the image itself)

## Details of a listed company

`GET /v1/companies/{symbol}`

Name, sector, industry, ISIN, market capitalisation, index memberships and logo URLs.

Parameters:

- `symbol` (path, required): Ticker, exchange-qualified ticker, Yahoo symbol or ISIN.
- `exchange` (query): Force an exchange. One of: nse, bse.

Example: https://api.dharun.dev/v1/companies/RELIANCE

Response, with lists and long text shortened:

```json
{
  "data": {
    "id": "NSE:RELIANCE",
    "exchange": "NSE",
    "ticker": "RELIANCE",
    "company": "Reliance Industries Limited",
    "sector": "Energy Minerals",
    "industry": "Oil Refining/Marketing",
    "oneLine": "Reliance Industries Limited operates in the Oil Refining/Marketing industry within the Energy Minerals sector.",
    "isin": "INE002A01018",
    "currency": "INR",
    "marketCap": 18484771071653,
    "isIndexConstituent": true,
    "indexes": [
      "Nifty 50",
      "Nifty 500",
      "Nifty Infrastructure"
    ],
    "logo": {
      "png": "https://api.dharun.dev/v1/logos/NSE:RELIANCE?format=png&size=128",
      "svg": "https://api.dharun.dev/v1/logos/NSE:RELIANCE"
    },
    "links": {
      "self": "https://api.dharun.dev/v1/companies/NSE:RELIANCE"
    }
  },
  "meta": {
    "source": {
      "name": "Indian listed company logos",
      "url": "https://github.com/dharunashokkumar/api.dharun.dev",
      "licence": "Logos are trademarks of the companies they identify",
      "retrieved": "2026-04-29",
      "attribution": "Company logos and trademarks belong to their respective owners."
    }
  }
}
```

## Search listed companies

`GET /v1/companies`

Searches ticker, company name, sector, industry, ISIN and index names. Best match first.

Parameters:

- `q` (query): Search text.
- `exchange` (query): Limit to one exchange. One of: nse, bse.
- `sector` (query): Exact sector name.
- `index` (query): Index name, for example Nifty 50.
- `limit` (query): Results per page, 1 to 100.
- `offset` (query): Results to skip.

Example: https://api.dharun.dev/v1/companies?q=tata&limit=5

Response, with lists and long text shortened:

```json
{
  "data": [
    {
      "id": "NSE:TATASTEEL",
      "exchange": "NSE",
      "ticker": "TATASTEEL",
      "company": "Tata Steel Limited",
      "sector": "Non-Energy Minerals",
      "industry": "Steel",
      "oneLine": "Tata Steel Limited operates in the Steel industry within the Non-Energy Minerals sector.",
      "isin": "INE081A01020",
      "currency": "INR",
      "marketCap": 2665234130371,
      "isIndexConstituent": true,
      "indexes": [
        "Nifty 50",
        "Nifty 500",
        "Nifty Metal"
      ],
      "logo": {
        "png": "https://api.dharun.dev/v1/logos/NSE:TATASTEEL?format=png&size=128",
        "svg": "https://api.dharun.dev/v1/logos/NSE:TATASTEEL"
      },
      "links": {
        "self": "https://api.dharun.dev/v1/companies/NSE:TATASTEEL"
      }
    },
    {
      "id": "NSE:TATAPOWER",
      "exchange": "NSE",
      "ticker": "TATAPOWER",
      "company": "Tata Power Company Limited",
      "sector": "Utilities",
      "industry": "Electric Utilities",
      "oneLine": "Tata Power Company Limited operates in the Electric Utilities industry within the Utilities sector.",
      "isin": "INE245A01021",
      "currency": "INR",
      "marketCap": 1448766954960,
      "isIndexConstituent": true,
      "indexes": [
        "Nifty 500",
        "Nifty Next 50",
        "Nifty Infrastructure"
      ],
      "logo": {
        "png": "https://api.dharun.dev/v1/logos/NSE:TATAPOWER?format=png&size=128",
        "svg": "https://api.dharun.dev/v1/logos/NSE:TATAPOWER"
      },
      "links": {
        "self": "https://api.dharun.dev/v1/companies/NSE:TATAPOWER"
      }
    },
    {
      "id": "NSE:TATACAP",
      "exchange": "NSE",
      "ticker": "TATACAP",
      "company": "Tata Capital Ltd.",
      "sector": "Finance",
      "industry": "Finance/Rental/Leasing",
      "oneLine": "Tata Capital Ltd. operates in the Finance/Rental/Leasing industry within the Finance sector.",
      "isin": "INE976I01016",
      "currency": "INR",
      "marketCap": 1415663811500,
      "isIndexConstituent": true,
      "indexes": [
        "Nifty 500",
        "Nifty Next 50",
        "Nifty 200"
      ],
      "logo": {
        "png": "https://api.dharun.dev/v1/logos/NSE:TATACAP?format=png&size=128",
        "svg": "https://api.dharun.dev/v1/logos/NSE:TATACAP"
      },
      "links": {
        "self": "https://api.dharun.dev/v1/companies/NSE:TATACAP"
      }
    }
  ],
  "meta": {
    "total": 17,
    "limit": 5,
    "offset": 0,
    "source": {
      "name": "Indian listed company logos",
      "url": "https://github.com/dharunashokkumar/api.dharun.dev",
      "licence": "Logos are trademarks of the companies they identify",
      "retrieved": "2026-04-29",
      "attribution": "Company logos and trademarks belong to their respective owners."
    }
  }
}
```

## Data source

- [Indian listed company logos](https://github.com/dharunashokkumar/api.dharun.dev), retrieved 2026-04-29. Licence: Logos are trademarks of the companies they identify. Company logos and trademarks belong to their respective owners.

## Guides

- [Show NSE and BSE company logos in your app](https://api.dharun.dev/guides/company-logos.md): Put a listed company's logo in an img tag by ticker or ISIN, as SVG or sized PNG, with an initials tile when no logo exists.