curl -X GET "https://api.finscreener.in/api/gst/gst-filter?State=Maharashtra&Status=Active&TaxpayerType=Regular&page=1&limit=10" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"
import requests
response = requests.get(
"https://api.finscreener.in/api/gst/gst-filter",
params={
"State": "Maharashtra",
"Status": "Active",
"TaxpayerType": "Regular",
"page": 1,
"limit": 10
},
headers={"Authorization": f"Bearer {token}"}
)
gst_records = response.json()
{
"results": [
{
"GSTIN": "27AAACR5055K1ZZ",
"TradeName": "RELIANCE INDUSTRIES LIMITED",
"Status": "Active",
"TaxpayerType": "Regular",
"State": "Maharashtra",
"COREBUSINESS": "Manufacturer"
}
],
"total_results": 1523,
"page": 1,
"limit": 10
}
Advanced Filters
Filter GST
Filter and search GST registrations by various criteria
GET
/
api
/
gst
/
gst-filter
curl -X GET "https://api.finscreener.in/api/gst/gst-filter?State=Maharashtra&Status=Active&TaxpayerType=Regular&page=1&limit=10" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"
import requests
response = requests.get(
"https://api.finscreener.in/api/gst/gst-filter",
params={
"State": "Maharashtra",
"Status": "Active",
"TaxpayerType": "Regular",
"page": 1,
"limit": 10
},
headers={"Authorization": f"Bearer {token}"}
)
gst_records = response.json()
{
"results": [
{
"GSTIN": "27AAACR5055K1ZZ",
"TradeName": "RELIANCE INDUSTRIES LIMITED",
"Status": "Active",
"TaxpayerType": "Regular",
"State": "Maharashtra",
"COREBUSINESS": "Manufacturer"
}
],
"total_results": 1523,
"page": 1,
"limit": 10
}
Filter GST registrations based on multiple criteria including trade name, state, taxpayer type, status, and more.
Headers
string
required
Bearer token:
Bearer <access_token>Query Parameters
string
Filter by GSTIN
string
Search by trade name (partial match)
string
Filter by business activity
string
Filter by status (Active, Cancelled, etc.)
string
Filter by taxpayer type (Regular, Composition, etc.)
string
Registration date range start (YYYY-MM-DD)
string
Registration date range end (YYYY-MM-DD)
string
Filter by core business type
number
Filter by total income
number
Filter by turnover
string
Search by address
string
Filter by state
string
Filter by district
string
Filter by goods description
string
Filter by services description
number
default:"1"
Page number
number
default:"10"
Results per page (max: 100)
curl -X GET "https://api.finscreener.in/api/gst/gst-filter?State=Maharashtra&Status=Active&TaxpayerType=Regular&page=1&limit=10" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"
import requests
response = requests.get(
"https://api.finscreener.in/api/gst/gst-filter",
params={
"State": "Maharashtra",
"Status": "Active",
"TaxpayerType": "Regular",
"page": 1,
"limit": 10
},
headers={"Authorization": f"Bearer {token}"}
)
gst_records = response.json()
{
"results": [
{
"GSTIN": "27AAACR5055K1ZZ",
"TradeName": "RELIANCE INDUSTRIES LIMITED",
"Status": "Active",
"TaxpayerType": "Regular",
"State": "Maharashtra",
"COREBUSINESS": "Manufacturer"
}
],
"total_results": 1523,
"page": 1,
"limit": 10
}