GSTIN details API reference

GSTIN details

Returns GST registration details: legal name, status, constitution and address.

Endpoint

POST https://api.finovel.in/v1/gstin-details

Charged only when the call succeeds. Errors are never charged. See how every API works for keys, retries and status codes.

Request fields

Field	Type	Required	Description
`id_number`	text	Yes	GSTIN

Example request

curl -X POST https://api.finovel.in/v1/gstin-details \
  -H "Authorization: Bearer fin_test_your_key" \
  -H "Content-Type: application/json" \
  -d '{"id_number":"27ABCDE1234F1Z5"}'

Response fields

Inside data:

Field	Description
`legal_name`	Legal name
`business_name`	Trade name
`gstin_status`	Status
`taxpayer_type`	Taxpayer type
`constitution_of_business`	Constitution
`date_of_registration`	Registered on
`address`	Address

Example response from the sandbox

{
  "request_id": "req_...",
  "success": true,
  "status": "success",
  "environment": "sandbox",
  "message": "OK",
  "data": {
    "gstin": "27ABCDE1234F1Z5",
    "client_id": "corporate_gstin_sandbox",
    "legal_name": "SANDBOX TRADERS PRIVATE LIMITED",
    "gstin_status": "Active",
    "business_name": "SANDBOX TRADERS",
    "taxpayer_type": "Regular",
    "date_of_registration": "2019-07-01",
    "constitution_of_business": "Private Limited Company"
  },
  "error": null,
  "charged_paise": 0
}

Sandbox scenarios

With a test key, this API can return:

Not found (contains 0000)
Provider error (contains 9999)
Active GSTIN (default)