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

# GST Details

> Get detailed GST registration information by GSTIN

Retrieve comprehensive details for a GST registration by its GSTIN.

<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="gstin" type="string" required>
  GSTIN (e.g., `27AAACR5055K1ZZ`)
</ParamField>

## Response

<ResponseField name="data" type="object">
  <Expandable title="properties">
    <ResponseField name="GSTIN" type="string">GST Identification Number</ResponseField>
    <ResponseField name="LegalName" type="string">Legal name of business</ResponseField>
    <ResponseField name="TradeName" type="string">Trade name</ResponseField>
    <ResponseField name="Status" type="string">Active, Cancelled, etc.</ResponseField>
    <ResponseField name="TaxpayerType" type="string">Regular, Composition, etc.</ResponseField>
    <ResponseField name="ConstitutionBusiness" type="string">Business constitution type</ResponseField>
    <ResponseField name="dateOfRegistration" type="string">GST registration date</ResponseField>
    <ResponseField name="state" type="string">State of registration</ResponseField>
    <ResponseField name="Address" type="string">Principal place of business</ResponseField>
    <ResponseField name="Pincode" type="string">PIN code</ResponseField>
    <ResponseField name="COREBUSINESS" type="string">Core business activity</ResponseField>
    <ResponseField name="BusinessActivities" type="array">List of business activities</ResponseField>
    <ResponseField name="hsnCodes" type="array">HSN codes for goods dealt</ResponseField>
    <ResponseField name="sacCodes" type="array">SAC codes for services provided</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/gst/details?gstin=27AAACR5055K1ZZ" \
    -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
  ```

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

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

<ResponseExample>
  ```json Success theme={null}
  {
    "data": {
      "GSTIN": "27AAACR5055K1ZZ",
      "LegalName": "RELIANCE INDUSTRIES LIMITED",
      "TradeName": "RELIANCE INDUSTRIES LIMITED",
      "Status": "Active",
      "TaxpayerType": "Regular",
      "ConstitutionBusiness": "Public Limited Company",
      "dateOfRegistration": "2017-07-01",
      "state": "Maharashtra",
      "Address": "3rd Floor, Maker Chambers IV, 222 Nariman Point",
      "Pincode": "400021",
      "COREBUSINESS": "Manufacturer",
      "BusinessActivities": ["Factory/Manufacturing", "Wholesale Business"],
      "hsnCodes": ["2710", "3901", "3902"],
      "sacCodes": []
    },
    "rate_limit": {
      "remaining": 93,
      "limit": 100,
      "reset": "2026-03-21T00:00:00Z"
    }
  }
  ```
</ResponseExample>