# Get company master data

`GET /v1/companies/{cin}`

Group: Look up the register. Page: https://api.filesure.in/reference/get-company-master.md

**What it returns**

The full MCA master-data packet for a company:

- `companyData`: the MCA master record (registration, type/category/class, capital, status, dates, registered/correspondence addresses)
- `commonData`: MCA's supplementary record (NIC industry codes, AGM date, balance-sheet date). May be `null` if it has not been fetched yet
- `directorData[]`: the directors of this company. Rows deduped by DIN; `MCAUserRole[]` arrays merged, with a small drop list applied
- `indexChargesData[]`: charges (mortgages) on this company, verbatim. Empty `[]` is common (most companies have none)

Fields are surfaced **as MCA returns them** (camelCase, British spellings like `authorisedCapital`, PascalCase charge addresses); fields are only ever dropped, never renamed. The one addition: the three capital amounts (`paidUpCapital`, `authorisedCapital`, `subscribedCapital`) each carry readable companions beside the raw number — a `…Formatted` compact form (e.g. `₹7.69 Cr`) and a `…Display` full form with Indian digit grouping (e.g. `₹7,69,34,000`). The raw integers are unchanged; the ₹ sign carries the currency. **Address filtering:** only `Registered Address` and `Correspondence Address` are kept; auxiliary address types are dropped. Identifiers supported: 21-char **CIN**, 6-char **FCIN** (foreign), 8-char **LLPIN**. The `?idType=` query param is optional; auto-detect handles all three.

**Billing**

Billed per call against your INR wallet at the rate in your pricing row for this endpoint.

**Sandbox behavior**

Test keys (`fsk_test_*`) work freely on sandbox-whitelisted CINs/LLPINs (no wallet deduction). Outside the whitelist, test keys return `403 SANDBOX_ONLY`.

**Common errors**

- `400 INVALID_CIN` — identifier failed CIN/FCIN/LLPIN format validation
- `404` — company not found in our cache. The unlock endpoint won't help here either — it requires the CIN to already be in master data. If you need a specific CIN added (or you suspect ours is stale relative to MCA), contact [helpdesk@filesure.in](mailto:helpdesk@filesure.in).

Plus the global auth/wallet/permission errors — see the [error codes table](https://api.filesure.in/reference/start-here/responses-and-errors.md).

**See also**

- [List company filings](https://api.filesure.in/reference/list-company-filings.md)
- [List extracted form types](https://api.filesure.in/reference/list-extractions.md)
- [Unlock a company](https://api.filesure.in/reference/unlock-company.md)

## Parameters

| Name | In | Required | Type | Description |
|---|---|---|---|---|
| `cin` | path | yes | string | Company identifier. One of three formats — accepted on `/v1/companies/:cin`: - **CIN** — 21-character Indian Corporate Identification Number (e.g., U72900PB2022PTC055860) - **FCIN** — 6-character Foreign Company Identification Number (e.g., F07030) - **LLPIN** — 8-character LLP Identification Number (e.g., AAA-1234) Pair with the optional `?idType=cin\|fcin\|llpin` query param for stricter validation; auto-detect when omitted. Test keys (`fsk_test_*`) can only call identifiers in the **Sandbox** allowlist — see the Sandbox tag in the sidebar for the full list of 50 sample CINs and 2 LLPINs. |
| `idType` | query | no | string (`cin`, `fcin`, `llpin`) | Optional. Tighter validation when set; auto-detect when omitted. |

## Request example

Sandbox identifiers with a test key; nothing is charged.

```bash
curl "https://api.filesure.in/v1/companies/U74999HR2015FTC056386" \
  -H "x-api-key: fsk_test_..."
```

## Responses

**200** Master data found

*Sandbox CIN — CARS24 (registered company)*

```json
{
  "data": {
    "cin": "U74999HR2015FTC056386",
    "company": "CARS24 SERVICES PRIVATE LIMITED",
    "cinHistory": [],
    "nameHistory": [],
    "masterData": {
      "companyData": {
        "cin": "U74999HR2015FTC056386",
        "companyName": "CARS24 SERVICES PRIVATE LIMITED",
        "companyType": "Company limited by Shares",
        "companyOrigin": "Indian Non-Government Company",
        "companyCategory": "Company limited by Shares",
        "companySubcategory": "Non-government company",
        "classOfCompany": "Private",
        "dateOfIncorporation": "08/12/2015",
        "authorisedCapital": 100000000,
        "paidupCapital": 76934000,
        "numberOfMembers": "0",
        "activeCompliance": "ACTIVE compliant",
        "companyStatus": "Active",
        "whetherListedOrNot": "Unlisted",
        "MCAMDSCompanyAddress": [
          {
            "addressType": "Registered Address",
            "streetAddress": "Plot No. 78, Sector 44, Gurugram, Haryana, 122001",
            "country": "India"
          }
        ]
      },
      "commonData": {
        "mainDivisionCode": "74",
        "mainDivisionDescription": "Other professional, scientific and technical activities",
        "companyAddress": [
          {
            "addressType": "Registered Address",
            "streetAddress": "Plot No. 78, Sector 44, Gurugram, Haryana, 122001"
          }
        ]
      },
      "directorData": [
        {
          "DIN": "07347299",
          "PAN": "ABCPK1234E",
          "FirstName": "VIKRAM",
          "LastName": "CHOPRA",
          "dateOfAppointment": "08/12/2015",
          "DirectorDisqualified": "false",
          "MCAUserRole": [
            {
              "role": "Director",
              "designation": "Director",
              "cin": "U74999HR2015FTC056386",
              "kmpFlag": "false"
            }
          ]
        }
      ],
      "indexChargesData": [
        {
          "chargeId": "100123456",
          "chName": "HDFC BANK LIMITED",
          "chargeAmount": 5000000000,
          "dateOfCreation": "03/15/2022",
          "dateOfModification": null,
          "dateOfSatisfaction": null,
          "StreetAddress": "HDFC Bank House, Senapati Bapat Marg, Lower Parel, Mumbai",
          "City": "Mumbai",
          "State": "Maharashtra",
          "PostalCode": "400013",
          "Country": "India"
        }
      ]
    }
  },
  "meta": {
    "requestId": "…",
    "createdAt": "2023-04-12T07:18:32.444Z",
    "updatedAt": "2026-04-28T03:21:09.001Z"
  }
}
```

*Sandbox LLPIN — shape demo*

```json
{
  "data": {
    "cin": "ACK-2998",
    "company": "SUGEE TWENTY SEVEN DEVELOPERS LLP",
    "cinHistory": [],
    "nameHistory": [],
    "masterData": {
      "companyData": {
        "cin": "ACK-2998",
        "companyName": "SUGEE TWENTY SEVEN DEVELOPERS LLP",
        "companyType": "Limited Liability Partnership",
        "dateOfIncorporation": "11/11/2024",
        "numberOfPartners": "2",
        "numberOfDesignatedPartners": "2",
        "companyStatus": "Active"
      },
      "commonData": null,
      "directorData": null,
      "indexChargesData": []
    }
  },
  "meta": {
    "requestId": "…",
    "createdAt": "2023-08-22T14:12:08.901Z",
    "updatedAt": "2026-04-15T11:42:30.004Z"
  }
}
```

**400** Identifier failed format validation, or unknown idType value

*Identifier doesn't match CIN/FCIN/LLPIN format*

```json
{
  "error": {
    "code": "INVALID_CIN",
    "message": "The provided identifier failed format validation. Expected CIN, FCIN, or LLPIN."
  }
}
```

*Unknown idType query value*

```json
{
  "error": {
    "code": "INVALID_ID_TYPE",
    "message": "Unknown idType. Valid values: cin, fcin, llpin."
  }
}
```

**401** API key missing, invalid, or revoked

*Header absent*

```json
{
  "error": {
    "code": "MISSING_API_KEY",
    "message": "API key is required. Pass it via the x-api-key header."
  }
}
```

*Key not recognised*

```json
{
  "error": {
    "code": "INVALID_API_KEY",
    "message": "The provided API key is not valid."
  }
}
```

*Key revoked*

```json
{
  "error": {
    "code": "API_KEY_REVOKED",
    "message": "This API key has been revoked."
  }
}
```

**402** Wallet balance is below the endpoint price

```json
{
  "error": {
    "code": "INSUFFICIENT_BALANCE",
    "message": "Insufficient wallet balance. Please recharge.",
    "balancePaisa": 0,
    "requiredPaisa": 500
  }
}
```

**403** No pricing assigned, or test key tried to access non-sandbox CIN/DIN

*No pricing record (live key)*

```json
{
  "error": {
    "code": "NO_ACCESS",
    "message": "No access to endpoint 'companies.master'. Contact support to enable access.",
    "endpoint": "companies.master",
    "catalogPricePaisa": 500
  }
}
```

*Test key outside sandbox whitelist*

```json
{
  "error": {
    "code": "SANDBOX_ONLY",
    "message": "A test key only works on the sandbox companies and directors. They are listed in this response and at GET /v1/sandbox. Use one of those, or a live key.",
    "sandboxCompanies": [
      {
        "cin": "U74999HR2015FTC056386",
        "company": "CARS24 SERVICES PRIVATE LIMITED",
        "knownAs": "Cars24"
      },
      {
        "cin": "L93030DL2010PLC198141",
        "company": "ETERNAL LIMITED",
        "knownAs": "Eternal, formerly Zomato"
      }
    ],
    "sandboxDirectors": [
      {
        "din": "11692472",
        "fullName": "NILESH KASHINATH HIWALE"
      }
    ],
    "nextStep": "GET /v1/sandbox"
  }
}
```

**404** Resource not found in master data