> ## 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.

# Recent Companies

> Get recently registered companies

Retrieve company incorporations within a specified date range.

<Note>
  Requires an entitlement for the `recently_registered.company` dataset. Call
  [`GET /api/access`](/api-reference/access) to see whether it is enabled, and the exact
  territory and date window that will be applied.
</Note>

<Warning>
  This endpoint enforces your entitlement. Requests are restricted to the states,
  districts and pincodes on your plan, and to your subscription-anchored date window.
  With no entitlement the request is refused with `403 NO_DATASET_ACCESS`.
</Warning>

## Headers

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

## Request Body

Send filter criteria as a JSON body. All fields are optional.

<ParamField body="from_date" type="string">
  Start date (YYYY-MM-DD). Clamped to the start of your entitled date window.
</ParamField>

<ParamField body="to_date" type="string">
  End date (YYYY-MM-DD)
</ParamField>

<ParamField body="search" type="string">
  Search term (CIN, company name)
</ParamField>

<ParamField body="state" type="string">
  Filter by state. Must fall within your entitled territory.
</ParamField>

<ParamField body="district" type="string">
  Filter by district. Comma-separated for multiple values.
</ParamField>

<ParamField body="pincode" type="string">
  Filter by pincode. Comma-separated for multiple values.
</ParamField>

<ParamField body="status" type="string">
  Filter by company status
</ParamField>

<ParamField body="business_type" type="string">
  Filter by business type
</ParamField>

<ParamField body="page" type="number" default="1">
  Page number
</ParamField>

<ParamField body="limit" type="number" default="10">
  Results per page
</ParamField>

## Response

<ResponseField name="data" type="array">
  The matching company incorporations.
</ResponseField>

<ResponseField name="total" type="number">
  Total number of matching records within your entitled scope.
</ResponseField>

<ResponseField name="page" type="number">
  Current page.
</ResponseField>

<ResponseField name="limit" type="number">
  Page size.
</ResponseField>

<ResponseField name="access" type="object">
  The scope that was actually applied to this response.

  <Expandable title="access properties">
    <ResponseField name="granted_by" type="string">
      `subscription`, `offer`, or `enterprise`
    </ResponseField>

    <ResponseField name="territory" type="object">
      `restricted`, `states`, `districts`, `pincodes`
    </ResponseField>

    <ResponseField name="date_window" type="object">
      `from`, `to`, `anchored_to_subscription`
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST "https://api.finscreener.in/api/recently-registered/companies" \
    -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
    -H "Content-Type: application/json" \
    -d '{
      "from_date": "2026-07-01",
      "to_date": "2026-07-18",
      "state": "Maharashtra"
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json Success theme={null}
  {
    "data": [
      {
        "CIN": "U72200MH2026PTC148441",
        "company": "EXAMPLE TECHNOLOGIES PRIVATE LIMITED",
        "dateOfIncorporation": "2026-07-12T00:00:00",
        "companyType": "Company limited by Shares",
        "classOfCompany": "Private",
        "companyCategory": "Company limited by Shares",
        "mainDivision": "62",
        "mainDivisionDescription": "Computer programming, consultancy and related activities",
        "city": "Mumbai",
        "district": "Mumbai",
        "state": "Maharashtra",
        "pincode": "400001"
      }
    ],
    "total": 1187,
    "page": 1,
    "limit": 10,
    "access": {
      "granted_by": "subscription",
      "territory": {
        "restricted": true,
        "states": ["Maharashtra"],
        "districts": null,
        "pincodes": null
      },
      "date_window": {
        "from": "2026-07-07",
        "to": "2026-07-18",
        "anchored_to_subscription": true
      }
    }
  }
  ```

  ```json 403 No Access theme={null}
  {
    "error_code": "NO_DATASET_ACCESS",
    "dataset": "recently_registered.company",
    "message": "This API key has no access to recently registered COMPANY data. See GET /api/access.",
    "reason": "no_active_plan_grants_this_dataset"
  }
  ```
</ResponseExample>