# Tofler API — Indian company & director data (MCA): search by name/CIN/DIN, company profile, board with appointment dates, financials, charges, network, state x industry directory

> Find Indian companies, LLPs and directors on Tofler. Matches company names (the site's own autocomplete, best 10), an exact CIN / LLPIN (1 company) or an exact 8-digit DIN (1 director). Person names are not searched by the site; use a DIN. No paging: the source returns at most 10 rows.
> ReefAPI engine `tofler` · 7 endpoints · clean JSON, no scraping or browsers to manage.

## How to call
- **Endpoint:** `POST https://api.reefapi.com/tofler/v1/<action>` with a JSON body.
- **Auth:** header `x-api-key: <YOUR_REEFAPI_KEY>` — create one free (1,000 credits, no card): https://reefapi.com/signup
- **Response (every call):** `{ ok: boolean, data: ..., meta: { record_count, credits, ... }, error: { code, message } }` — branch on `ok`. Failed calls are free.
- **One key + one shared credit pool** across every ReefAPI API. Per-call credits are listed on each endpoint below.
- **Use it from an AI agent (MCP):** connect `https://api.reefapi.com/mcp` (remote streamable-http). Clients that add connectors by URL, such as ChatGPT and the Claude app, connect with OAuth 2.1 (the user pastes their key once on a ReefAPI page; discovery at `/.well-known/oauth-protected-resource/mcp`). Config files send the key as `Authorization: Bearer <key>`. `?key=<key>` in the URL also works as a last-resort fallback.

## Endpoints

### POST https://api.reefapi.com/tofler/v1/search — 1 credit
Find Indian companies, LLPs and directors on Tofler. Matches company names (the site's own autocomplete, best 10), an exact CIN / LLPIN (1 company) or an exact 8-digit DIN (1 director). Person names are not searched by the site; use a DIN. No paging: the source returns at most 10 rows.

**Parameters:**
- `query` (string, required) — Company name or part of it (`infosys`, `tata steel`), a CIN (`L85110KA1981PLC013115`), an LLPIN (`AAN-5420`) or a DIN (`01876159`).

**Returns:** results[]{type (company|director), label (as printed), name, also_known_as, is_old_name, id, cin, id_type (cin|llpin|fcrn|din), din, status, url} + count + query

**Example request body:**
```json
{
  "query": "infosys"
}
```

### POST https://api.reefapi.com/tofler/v1/company — 2 credits
The full public Tofler profile of one Indian company or LLP: status, listed/unlisted, class, type badges, incorporation date and age, authorised / paid-up (or LLP contributed) capital in rupees, registered address and the company e-mail Tofler publishes, website, state and industry, industry tags and products, revenue band, last AGM date, Tofler Score with risk flags, key metrics with year-on-year change, the board (DIN or PAN, designation, tenure, shareholder badge, exact appointment date), every office / plant / registered location with pincode and coordinates, registered charges (holder, amount, date), up to five years of balance sheet, profit and loss and ratios (standalone and consolidated, in INR crore, plus common-size %) where the page publishes them, companies connected through directors and subsidiaries. Figures Tofler keeps for its paid tier are null and counted.

**Parameters:**
- `company_id` (string, required) — The company's CIN (21 characters, e.g. `L85110KA1981PLC013115`), an LLP's LLPIN (`AAN-5420`), a foreign company's FCRN, or a tofler.in company link. Get it from `search` or `company_list`.

**Returns:** cin, id_type, name, url, status, page_updated, description, summary[], is_listed, company_class, type_badges[], website, email, state, state_slug, industry, industry_slug, industry_tags[], products[], located_in, registered_address, incorporation_date, incorporation_year, age_years, authorised_capital_inr/_text, paid_up_capital_inr/_text, contributed_capital_inr/_text, revenue_band_card, operating_revenue_range, financial_year_end, ebitda_change_pct, networth_change_pct, last_agm_date, agm_card, directors_count_stated, registered_details{}, key_metrics{period, rows[]}, tofler_score{rating, severe_risks[], moderate_risks[], low_risks[]}, directors[]{name, designation, din, pan, tenure_text, tenure_years, is_shareholder, appointment_date, url}, locations[]{type, address, state, pincode, latitude, longitude, map_label}, charges[]{charge_holder, amount_inr, amount_text, date}, financials{highlights, standalone{balance_sheet, balance_sheet_pct_of_assets, profit_and_loss, profit_and_loss_pct_of_total_income, ratios}, consolidated{…}, paywalled_cells, published_cells}, connected_companies[], subsidiaries[]

**Example request body:**
```json
{
  "company_id": "U31100KA2020PTC133739"
}
```

### POST https://api.reefapi.com/tofler/v1/financials — 1 credit
Only the money view of a company page: key metrics with year-on-year change, the five-year highlights, standalone and consolidated balance sheet, profit and loss and ratios (INR crore and common-size %), revenue band and registered charges. Same page as `company`, one request, without the board and network lists. Cells Tofler keeps for its paid tier are null (`paywalled_cells`); a table the page shows blurred but publishes in its HTML is returned with `blurred_on_page: true`.

**Parameters:**
- `company_id` (string, required) — The company's CIN (21 characters, e.g. `L85110KA1981PLC013115`), an LLP's LLPIN (`AAN-5420`), a foreign company's FCRN, or a tofler.in company link. Get it from `search` or `company_list`.

**Returns:** cin, name, url, status, financial_year_end, revenue_band_card, operating_revenue_range, key_metrics, financials, charges[], charges_note

**Example request body:**
```json
{
  "company_id": "U31100KA2020PTC133739"
}
```

### POST https://api.reefapi.com/tofler/v1/network — 2 credits
Only the relationship view of a company: the board (with exact appointment dates), companies connected through common directors (status, paid-up capital, number of common directors, state) and subsidiaries (Indian ones with CIN and paid-up capital, foreign ones with country).

**Parameters:**
- `company_id` (string, required) — The company's CIN (21 characters, e.g. `L85110KA1981PLC013115`), an LLP's LLPIN (`AAN-5420`), a foreign company's FCRN, or a tofler.in company link. Get it from `search` or `company_list`.

**Returns:** cin, name, url, status, directors[], connected_companies[]{name, cin, url, status, paid_up_capital_inr, paid_up_capital_text, common_directors, state}, subsidiaries[]{name, cin, url, location, incorporation_year, paid_up_capital_inr, paid_up_capital_text} + counts

**Example request body:**
```json
{
  "company_id": "U31100KA2020PTC133739"
}
```

### POST https://api.reefapi.com/tofler/v1/directors — 1 credit
The current signatories of a company from the MCA registry data Tofler's network graph uses: DIN (or a PAN-type id for company secretaries / CFOs), name, designation and the exact appointment date, one row per registry role (one person can hold two). One small request (1-5 KB); use `company` for tenure, shareholder badge and PAN-only officers.

**Parameters:**
- `company_id` (string, required) — The company's CIN (21 characters, e.g. `L85110KA1981PLC013115`), an LLP's LLPIN (`AAN-5420`), a foreign company's FCRN, or a tofler.in company link. Get it from `search` or `company_list`.

**Returns:** cin, directors[]{din, pan, name, designation, appointment_date, url} + count

**Example request body:**
```json
{
  "company_id": "L85110KA1981PLC013115"
}
```

### POST https://api.reefapi.com/tofler/v1/director — 2 credits
One director by DIN: name, every company directorship (company, CIN, incorporation date, industry, company status, date of appointment, 'as on' date, designation, the company's paid-up capital), LLP seats the page leaves out but the registry data lists, the active association / people association / longest association counts the page prints, and the other people Tofler links to this director (name + DIN).

**Parameters:**
- `din` (string, required) — The director's 8-digit DIN (Director Identification Number, e.g. `01876159`) or a tofler.in director link. Shorter numbers are zero-padded.

**Returns:** din, name, url, summary, active_companies_stated, active_business_associations, people_associations, longest_association_years, industries[], directorships[]{company_name, cin, url, incorporation_date, incorporation_year, industry, status, appointment_date, as_on_date, designation, paid_up_capital_inr, paid_up_capital_text, on_director_page, in_network_data}, associated_people[]{name, din, url} + count

**Example request body:**
```json
{
  "din": "01876159"
}
```

### POST https://api.reefapi.com/tofler/v1/company_list — 1 credit
Tofler's directory of ACTIVE Indian companies by state and/or industry (the site's own 36 states x 30 industries), 30 per page. The site serves pages 1-20 only (600 companies per list) and prints no total; `has_more` is false on page 20. Order is the site's own.

**Parameters:**
- `state` (string, optional) — State or union territory, as a slug (`karnataka`, `tamil-nadu`) or the site's name (`Tamil Nadu`, `Jammu & Kashmir`). At least one of state / industry is required. [one of: andaman-and-nicobar, andhra-pradesh, arunachal-pradesh, assam, bihar, chandigarh, chhattisgarh, dadar-and-nager-haveli, daman-and-diu, delhi, goa, gujarat, haryana, himachal-pradesh, jammu-and-kashmir, jharkhand, karnataka, kerala, lakshadweep, madhya-pradesh, maharashtra, manipur, meghalaya, mizoram, nagaland, odisha, pondicherry, punjab, rajasthan, sikkim, tamil-nadu, telangana, tripura, uttar-pradesh, uttarakhand, west-bengal]
- `industry` (string, optional) — Industry, as a slug (`computer-related-services`, `finance`) or the site's name (`Computer Related Services`). Combine with `state` to narrow. [one of: agriculture, mining-and-quarrying, manufacturing-food-products, manufacturing-tobacco-products, manufacturing-textiles, manufacturing-wearing-apparel, manufacturing-leather-products, manufacturing-wood-products, manufacturing-paper-products, manufacturing-chemical-products, manufacturing-machinery, manufacturing-motor-vehicles, general-manufacturing, electricity-gas-and-water, construction, trading, hotels-and-restaurants, transport-and-storage, transport-services, post-and-telecom, finance, insurance, real-estate-and-renting, computer-related-services, research-and-development, business-services, community-and-social-services, education, health-and-social-work, recreational-cultural-and-sporting-activities]
- `page` (integer, optional, default 1) — Page number, 1-20 (30 companies per page; the site serves no page after 20).

**Returns:** results[]{name, cin, id_type, url, incorporation_year, industry, status} + count + page + page_size + has_more + page_beyond_last + max_page + state + industry

**Example request body:**
```json
{
  "state": "karnataka",
  "industry": "computer-related-services"
}
```

## At scale
- **Volume:** 5M+ requests a day, measured at 60 requests a second across the fleet with no
  central bottleneck. Per-key limits are raised for high-volume accounts; volume pricing on request.
- **Missing a source:** tell us a site we do not cover and it becomes an engine. A customer asked
  for bestprice.gr on 21 Sep 2026 and it was in the catalog on 22 Sep.
- **Support:** 2 minute median time from a question in the live chat to the first answer. Setup
  help included, no support tier to buy.
- **One key, one credit pool** across every API. No per-site plans, no separate subscriptions.

## More
- Try it live, no code: https://reefapi.com/playground?engine=tofler
- Human docs page: https://reefapi.com/docs/tofler
- Overview page: https://reefapi.com/tofler-api
- Every ReefAPI API in one file (for your AI): https://reefapi.com/llms-full.txt
