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

# Get Entity as Lead

> Convert any entity to Zoho lead format

Get a GST registration formatted as a Zoho CRM lead.

<Warning>
  Requires an **active subscription** with access to recently registered data:

  * `gst` → Requires **Recent\_GST** feature
</Warning>

## Headers

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

## Request Body

<ParamField body="entity_type" type="string" required>
  Entity type: `gst`
</ParamField>

<ParamField body="identifier" type="string" required>
  Entity identifier (GSTIN)
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST "https://api.finscreener.in/api/crm/newlead" \
    -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
    -H "Content-Type: application/json" \
    -d '{
      "entity_type": "gst",
      "identifier": "27AABCU9603R1ZM"
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json Success theme={null}
  {
    "success": true,
    "entity_type": "gst",
    "identifier": "27AABCU9603R1ZM",
    "lead": {
      "Last_Name": "EXAMPLE TRADERS",
      "Company": "EXAMPLE TRADERS",
      "Email": "contact@example.com",
      "Phone": null,
      "City": "Mumbai",
      "State": "Maharashtra",
      "Lead_Source": "Finscreener",
      "GSTIN": "27AABCU9603R1ZM"
    },
    "full_data": {
      "company": null,
      "directors": [],
      "gst": [
        {
          "GSTIN": "27AABCU9603R1ZM",
          "TradeName": "EXAMPLE TRADERS",
          "Status": "Active"
        }
      ]
    }
  }
  ```

  ```json No Subscription Error theme={null}
  {
    "detail": "Subscription required: An active subscription or offer is required to access recently registered GSTs."
  }
  ```
</ResponseExample>