POST /v1/data/gst-info/taxpayer/run
Pricing: $0.05 per taxpayer ($50.00 per 1,000).
One or more 15-character GSTINs.
Request
Send the inputs underparams. Only the keys below are accepted; any other key returns 422 invalid_params.
One or more 15-character GSTINs. Each is checksum-validated before anything is fetched, so a typo costs nothing. Each GSTIN returns one row.
Stop after this many have been looked up. Each one costs a row, so this caps the bill as well as the output. 0 or omitted means every id you sent.
Example
curl -X POST "https://api.mindcase.co/v1/data/gst-info/taxpayer/run?wait=true" \
-H "Authorization: Bearer $MINDCASE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"params": {
"gstins": [
"27AAECF2014J1ZW"
]
}
}'
import os, requests
r = requests.post(
"https://api.mindcase.co/v1/data/gst-info/taxpayer/run",
params={"wait": "true"},
headers={"Authorization": f"Bearer {os.environ['MINDCASE_API_KEY']}"},
json={"params": {
"gstins": [
"27AAECF2014J1ZW"
]
}},
)
job = r.json()
rows = job.get("data", []) # if job["status"] == "running", poll /v1/jobs/{job_id}/results
const r = await fetch("https://api.mindcase.co/v1/data/gst-info/taxpayer/run?wait=true", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.MINDCASE_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({ params: {
"gstins": [
"27AAECF2014J1ZW"
]
} }),
});
const job = await r.json();
const rows = job.data ?? []; // if job.status === "running", poll /v1/jobs/{job_id}/results
Response fields
Each row indata is one taxpayer, keyed by these fields.
| Field | Name | Type |
|---|---|---|
gstin | GSTIN | text |
legalName | Legal Name | text |
tradeName | Trade Name | text |
registrationStatus | Registration Status | text |
taxpayerType | Taxpayer Type | text |
constitutionOfBusiness | Constitution of Business | text |
businessNatureCode | Nature of Core Business | text |
registrationDate | Registration Date | date |
cancellationDate | Cancellation Date | date |
principalPlaceOfBusiness | Principal Place of Business | text |
natureOfBusinessActivities | Nature of Business Activities | array |
stateJurisdiction | State Jurisdiction | text |
centreJurisdiction | Centre Jurisdiction | text |
aadhaarVerified | Aadhaar Verified | text |
aadhaarVerificationDate | Aadhaar Verification Date | date |
eKycVerified | eKYC Verified | text |
eKycVerificationDate | eKYC Verification Date | date |
eInvoiceEnabled | e-Invoice Enabled | text |
compositionRate | Composition Rate | text |
fieldVisitConducted | Field Visit Conducted | text |
financialYears | Registered Financial Years | object_array |
hsnGoods | HSN Goods | object_array |
sacServices | SAC Services | object_array |
returnFilings | Return Filings | object_array |
filingPreferences | Filing Preferences | object_array |
additionalTradeNames | Additional Trade Names | array |
scrapedAt | Scraped At | date |
Example response
Abridged: long text and lists are shortened.{
"job_id": "7f3a1c2e-0b9d-4c55-9a51-3f2e8d1b6a40",
"agent": "gst-info/taxpayer",
"status": "completed",
"row_count": 1,
"truncated": false,
"data": [
{
"natureOfBusinessActivities": [
"Wholesale Business"
],
"additionalTradeNames": [],
"constitutionOfBusiness": "Private Limited Company",
"filingPreferences": [
{
"financialYear": "2020",
"quarter": "Q3",
"preference": "N"
},
{
"financialYear": "2020",
"quarter": "Q4",
"preference": "M"
}
],
"hsnGoods": [
{
"hsnCode": "0703",
"description": "ONIONS, SHALLOTS, GARLIC, LEEKS AND OTHER ALLIACEOUS VEGETABLES, FRESH OR CHILLED"
},
{
"hsnCode": "0709",
"description": "OTHER VEGETABLES, FRESH OR CHILLED"
}
],
"principalPlaceOfBusiness": "81, New APMC MARKET, Panchavti, Nashik, Nashik, Maharashtra, 422306",
"aadhaarVerified": "Yes",
"financialYears": [
{
"year": "2020-2021",
"code": "2020"
},
{
"year": "2021-2022",
"code": "2021"
}
],
"cancellationDate": "09/08/2021",
"sacServices": [],
"eKycVerificationDate": null,
"registrationDate": "27/11/2020",
"centreJurisdiction": "State - CBIC,Zone - NAGPUR,Commissionerate - NASHIK,Division - NASHIK-II DIVISION,Range - NIPHAD RANGE (Jurisdictional Office)",
"stateJurisdiction": "State - Maharashtra,Zone - Nashik,Division - NASHIK,Charge - NASHIK_CITY_701",
"scrapedAt": "2026-09-24T12:34:21.117958+00:00",
"gstin": "27AAECF2014J1ZW",
"legalName": "FIRST RIPE AGRO EXPORT (OPC) PRIVATE LIMITED",
"aadhaarVerificationDate": "24/11/2020",
"taxpayerType": "Regular",
"tradeName": "FIRST RIPE AGRO EXPORT (OPC) PRIVATE LIMITED",
"eInvoiceEnabled": "No",
"eKycVerified": "Not Applicable",
"compositionRate": "NA",
"fieldVisitConducted": "No",
"returnFilings": []
}
]
}