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

> Get recently registered GST

Retrieve GST registrations within a specified date range.

<Note>
  Requires **Recent\_GST** subscription feature.
</Note>

## 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)
</ParamField>

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

<ParamField body="state" type="string">
  Filter by state
</ParamField>

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

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

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

<ResponseExample>
  ```json Success theme={null}
  {
    "gst": [
      {
        "GSTIN": "29ABCDE1234F1ZA",
        "LegalName": "NEW BUSINESS SERVICES",
        "TradeName": "NBS SOLUTIONS",
        "dateOfRegistration": "2026-01-15",
        "state": "Karnataka",
        "Status": "Active",
        "TaxpayerType": "Regular"
      }
    ],
    "total": 2341,
    "page": 1,
    "pages": 47
  }
  ```
</ResponseExample>