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-07-01",
"to_date": "2026-07-18",
"state": "Karnataka"
}'
{
"data": [
{
"GSTIN": "29ABCDE1234F1ZA",
"LegalName": "NEW BUSINESS SERVICES",
"TradeName": "NBS SOLUTIONS",
"ConstitutionBusiness": "Private Limited Company",
"Status": "Active",
"TaxpayerType": "Regular",
"DateOfRegistration": "2026-07-15T00:00:00",
"district": "Bengaluru Urban",
"stateName": "Karnataka",
"pincode": "560001"
}
],
"total": 2341,
"page": 1,
"limit": 10,
"access": {
"granted_by": "subscription",
"territory": {
"restricted": true,
"states": ["Karnataka"],
"districts": null,
"pincodes": null
},
"date_window": {
"from": "2026-07-07",
"to": "2026-07-18",
"anchored_to_subscription": true
}
}
}
{
"error_code": "NO_DATASET_ACCESS",
"dataset": "recently_registered.gst",
"message": "This API key has no access to recently registered GST data. See GET /api/access.",
"reason": "no_active_plan_grants_this_dataset"
}
Recently Registered
Recent GST
Get recently registered GST
POST
/
api
/
recently-registered
/
gst
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-07-01",
"to_date": "2026-07-18",
"state": "Karnataka"
}'
{
"data": [
{
"GSTIN": "29ABCDE1234F1ZA",
"LegalName": "NEW BUSINESS SERVICES",
"TradeName": "NBS SOLUTIONS",
"ConstitutionBusiness": "Private Limited Company",
"Status": "Active",
"TaxpayerType": "Regular",
"DateOfRegistration": "2026-07-15T00:00:00",
"district": "Bengaluru Urban",
"stateName": "Karnataka",
"pincode": "560001"
}
],
"total": 2341,
"page": 1,
"limit": 10,
"access": {
"granted_by": "subscription",
"territory": {
"restricted": true,
"states": ["Karnataka"],
"districts": null,
"pincodes": null
},
"date_window": {
"from": "2026-07-07",
"to": "2026-07-18",
"anchored_to_subscription": true
}
}
}
{
"error_code": "NO_DATASET_ACCESS",
"dataset": "recently_registered.gst",
"message": "This API key has no access to recently registered GST data. See GET /api/access.",
"reason": "no_active_plan_grants_this_dataset"
}
Retrieve GST registrations within a specified date range.
Requires an entitlement for the
recently_registered.gst dataset. Call
GET /api/access to see whether it is enabled, and the exact
territory and date window that will be applied.This endpoint enforces your entitlement. Requests are restricted to the states,
districts and pincodes on your plan, and to your subscription-anchored date window —
dates outside that window return no rows rather than an error. With no entitlement the
request is refused with
403 NO_DATASET_ACCESS.Headers
string
required
Bearer token:
Bearer <access_token>Request Body
Send filter criteria as a JSON body. All fields are optional.string
Start date (YYYY-MM-DD). Clamped to the start of your entitled date window.
string
End date (YYYY-MM-DD)
string
Search term (GSTIN, legal name, trade name)
string
Filter by state. Must fall within your entitled territory.
string
Filter by district. Comma-separated for multiple values.
string
Filter by pincode. Comma-separated for multiple values.
string
Filter by registration status (e.g.
Active)string
Filter by constitution of business
number
default:"1"
Page number
number
default:"10"
Results per page
Response
array
The matching GST registrations.
number
Total number of matching records within your entitled scope.
number
Current page.
number
Page size.
object
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-07-01",
"to_date": "2026-07-18",
"state": "Karnataka"
}'
{
"data": [
{
"GSTIN": "29ABCDE1234F1ZA",
"LegalName": "NEW BUSINESS SERVICES",
"TradeName": "NBS SOLUTIONS",
"ConstitutionBusiness": "Private Limited Company",
"Status": "Active",
"TaxpayerType": "Regular",
"DateOfRegistration": "2026-07-15T00:00:00",
"district": "Bengaluru Urban",
"stateName": "Karnataka",
"pincode": "560001"
}
],
"total": 2341,
"page": 1,
"limit": 10,
"access": {
"granted_by": "subscription",
"territory": {
"restricted": true,
"states": ["Karnataka"],
"districts": null,
"pincodes": null
},
"date_window": {
"from": "2026-07-07",
"to": "2026-07-18",
"anchored_to_subscription": true
}
}
}
{
"error_code": "NO_DATASET_ACCESS",
"dataset": "recently_registered.gst",
"message": "This API key has no access to recently registered GST data. See GET /api/access.",
"reason": "no_active_plan_grants_this_dataset"
}