> ## Documentation Index
> Fetch the complete documentation index at: https://docs.finscreener.in/llms.txt
> Use this file to discover all available pages before exploring further.

# Company Details

> Get detailed company information by CIN

Retrieve comprehensive details for a company by its CIN (Corporate Identity Number).

<Warning>
  This endpoint is **rate limited** to 100 requests per day across all detail endpoints.
</Warning>

## Headers

<ParamField header="Authorization" type="string" required>
  Bearer token: `Bearer <access_token>`
</ParamField>

## Query Parameters

<ParamField query="cin" type="string" required>
  Company CIN (e.g., `U72200MH2004PTC148441`)
</ParamField>

## Response

<ResponseField name="data" type="object">
  <Expandable title="properties">
    <ResponseField name="CIN" type="string">Corporate Identity Number</ResponseField>
    <ResponseField name="companyName" type="string">Registered company name</ResponseField>
    <ResponseField name="companyType" type="string">Company, LLP, etc.</ResponseField>
    <ResponseField name="classOfCompany" type="string">Private, Public, etc.</ResponseField>
    <ResponseField name="companyCategory" type="string">Limited by shares, etc.</ResponseField>
    <ResponseField name="llpStatus" type="string">Active, Struck Off, etc.</ResponseField>
    <ResponseField name="dateOfIncorporation" type="string">Incorporation date</ResponseField>
    <ResponseField name="authorisedCapital" type="number">Authorised capital in INR</ResponseField>
    <ResponseField name="paidUpCapital" type="number">Paid-up capital in INR</ResponseField>
    <ResponseField name="registeredAddress" type="string">Full registered address</ResponseField>
    <ResponseField name="City" type="string">City</ResponseField>
    <ResponseField name="State" type="string">State</ResponseField>
    <ResponseField name="Pincode" type="string">PIN code</ResponseField>
    <ResponseField name="email" type="string">Company email</ResponseField>
    <ResponseField name="NICCode" type="number">Primary NIC code</ResponseField>
    <ResponseField name="NICDescription" type="string">Industry description</ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="rate_limit" type="object">
  Rate limit information including remaining requests
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.finscreener.in/api/company/details?cin=U72200MH2004PTC148441" \
    -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      "https://api.finscreener.in/api/company/details",
      params={"cin": "U72200MH2004PTC148441"},
      headers={"Authorization": f"Bearer {token}"}
  )
  company = response.json()
  ```
</RequestExample>

<ResponseExample>
  ```json Success theme={null}
  {
    "data": {
      "CIN": "U72200MH2004PTC148441",
      "companyName": "TATA CONSULTANCY SERVICES LIMITED",
      "companyType": "Company",
      "classOfCompany": "Public",
      "companyCategory": "Company limited by shares",
      "llpStatus": "Active",
      "dateOfIncorporation": "2004-01-19",
      "authorisedCapital": 500000000,
      "paidUpCapital": 366000000,
      "registeredAddress": "9th Floor, Nirmal Building, Nariman Point",
      "City": "Mumbai",
      "State": "Maharashtra",
      "Pincode": "400021",
      "email": "investor.relations@tcs.com",
      "NICCode": 62011,
      "NICDescription": "Computer programming activities"
    },
    "rate_limit": {
      "remaining": 95,
      "limit": 100,
      "reset": "2026-03-21T00:00:00Z"
    }
  }
  ```
</ResponseExample>
