Get GSTIN Details

Verify GSTIN against the GST e-Invoice database using Sandbox APIs.

Overview

This API provides taxpayer details from the GST Portal for the given gstin.

Endpoint

HTTP MethodResource
GET/irp/tax-payer/gstin?gstin={gstin}

API Endpoint  Contact Us  Free Trial

Request

Follow the below guidelines to pass GSTIN in path parameters to call the API.

Headers

ParamTypeDescriptionExample
x-api-keystringAn API key is a public key to identify users when calling any Sandbox API.key_live_ZUQT5UEf4......
AuthorizationstringJWT Authorization token which is generated using e-Invoice Authentication API.eyJhsebihGyUf......

Query Parameter

ParamTypeDescriptionExample
gstinstring15-character alphanumeric unique identifier assigned to business entities registering under the GST regime. GSTIN of the business whose details are required.24AAACJ3770E2ZV

Sample CURL Request

curl --request GET \
     --url 'https://api.sandbox.co.in/irp/tax-payer/gstin?gstin=22AAAAA0000A1Z5' \
     --header 'Authorization: xxxxxxxxxx' \
     --header 'accept: application/json' \
     --header 'x-api-key: xxxxxxxxxx' \
     --header 'x-api-version: 1.0'

❗️

Test Environment Not Available

Response

ParamTypeDescriptionExample
GstinstringGSTIN for which the details are provided29AWGPV7107B1Z1
TradeNamestringTrade Name of the GSTIN .VIKAS EXPORTS
LegalNamestringLegal Name of the GSTINVIKAS EXPORTS
AddrBnmstringAddressRAMANAGARA
AddrBnostringAddress562160
AddrFlnostringFloor number1st floor
AddrStstringStreet6th main
AddrLocstringLocationCHANNAPATNA
StateCodenumState Code29
AddrPncdnumPIN code562160
TxpTypestringTaxpayer TypeREG
BlkStatusstringBlock Statusnull
DtRegstringDate of Registration2021-05-03
DtDRegstringDate of De-registration2021-05-04

Response Caching

Response caching is not available for this API. Learn more about our response caching mechanism here

Wallet Charges

Since the Get GSTIN Details API is a Paid API, a wallet charge of INR 0.25 + GST will take place.

Versioning

This API is currently in major version 1.0. Refer to our versioning policies here