Skip to main content
GET
/
api
/
filters
/
gst
curl -X GET "https://api.finscreener.in/api/filters/gst" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

{
  "states": ["Maharashtra", "Karnataka", "Gujarat", ...],
  "taxpayerTypes": ["Regular", "Composition", "Casual Taxable Person", "SEZ Unit"],
  "status": ["Active", "Inactive", "Suspended", "Cancelled", "Cancelled suo-moto"],
  "businessActivities": [
    {"code": "MFG", "description": "Factory/Manufacturing"},
    {"code": "RET", "description": "Retail Business"},
    {"code": "WHO", "description": "Wholesale Business"},
    {"code": "SER", "description": "Service Provision"}
  ],
  "hsnCodes": [
    {"code": "8471", "description": "Computers"},
    {"code": "8517", "description": "Telephones"}
  ],
  "sacCodes": [
    {"code": "998311", "description": "IT consulting services"},
    {"code": "998312", "description": "IT design and development"}
  ]
}
Retrieve available filter options for GST registration screening, including states, taxpayer types, and business activities.

​
Headers

​
Authorization
string
required
Bearer token: Bearer <access_token>

​
Response

​
states
array
List of Indian states
​
taxpayerTypes
array
GST taxpayer types (Regular, Composition, etc.)
​
status
array
GST registration status options
​
businessActivities
array
Business activity codes and descriptions
​
hsnCodes
array
Common HSN codes for goods
​
sacCodes
array
Common SAC codes for services
curl -X GET "https://api.finscreener.in/api/filters/gst" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

{
  "states": ["Maharashtra", "Karnataka", "Gujarat", ...],
  "taxpayerTypes": ["Regular", "Composition", "Casual Taxable Person", "SEZ Unit"],
  "status": ["Active", "Inactive", "Suspended", "Cancelled", "Cancelled suo-moto"],
  "businessActivities": [
    {"code": "MFG", "description": "Factory/Manufacturing"},
    {"code": "RET", "description": "Retail Business"},
    {"code": "WHO", "description": "Wholesale Business"},
    {"code": "SER", "description": "Service Provision"}
  ],
  "hsnCodes": [
    {"code": "8471", "description": "Computers"},
    {"code": "8517", "description": "Telephones"}
  ],
  "sacCodes": [
    {"code": "998311", "description": "IT consulting services"},
    {"code": "998312", "description": "IT design and development"}
  ]
}