Get GSTIN details
Sandbox API to get the tax payer and registered transporter’s details for a given GSTIN number from E-Way bill portal
Overview
This API takes in the GSTIN of the Requester(Taxpayer or Transporter) and gives the respective details associated with it.
Endpoint
HTTP Method | Resource |
---|---|
Get | /ewb/gstin?gstin={gstin} |
Request
Follow the below guidelines to pass GSTIN in path parameters to call the API.
Headers
Param | Type | Description | Example |
---|---|---|---|
x-api-key | string | An API key is a public key to identify users when calling any Sandbox API. | key_live_ZUQT5UEf4...... |
Authorization | string | JWT Authorization token which is generated using E-Way Bill Authentication API. | eyJhsebihGyUf...... |
Query Parameters
Param | Type | Description | Example |
---|---|---|---|
gstin | string | 15-character alpha-numeric unique identifier assigned to business entities registering under the GST regime | AAAAA0000A |
Once the values are added, Your curl will look something like this
curl --request GET \
--url 'https://api.sandbox.co.in/24?gstin=AAAAA0000A' \
--header 'Authorization: xxxxxxxxxx' \
--header 'accept: application/json' \
--header 'x-api-key: xxxxxxxxxx' \
--header 'x-api-version: 1.0'
Response
Param | Type | Description | Examples |
---|---|---|---|
gstin | string | 15-character alpha-numeric unique identifier assigned to business entities registering under the GST regime | 29AKLPM8755F1Z2 |
tradeName | string | Name that has the status of a trademark. | XYZ Traders |
legalName | string | Name in which the entity's formally registered name | NICTEST |
address1 | string | Address of the entity | SOME STREET |
address2 | string | Address of the entity | SOME CITY |
stateCode | num | State of Entity Possible value - 1 : JAMMU AND KASHMIR2 : HIMACHAL PRADESH3 : PUNJAB4 : CHANDIGARH5 : UTTARAKHAND6 : HARYANA7 : DELHI8 : RAJASTHAN9 : UTTAR PRADESH10 : BIHAR11 : SIKKIM12 : ARUNACHAL PRADESH13 : NAGALAND14 : MANIPUR15 : MIZORAM16 : TRIPURA17 : MEGHALAYA18 : ASSAM19 : WEST BENGAL20 : JHARKHAND21 : ORRISA22 : CHATTISGARH23 : MADHYA PRADESH24 : GUJARAT26 : DADAR AND NAGAR HAVELI & DAMAN AND DIU27 : MAHARASHTRA29 : KARNATAKA30 : GOA31 : LAKSHADWEEP32 : KERELA33 : TAMIL NADU34 : PUDUCHERRY35 : ANDAMAN AND NICOBAR36 : TELENGANA37 : ANDHRA PRADESH38 : LADAKH97 : OTHER TERRITORY99 : OTHER COUNTRY | 29 |
pinCode | num | Pincode of the entity | 560079 |
txpType | string | Taxpayment Type | |
status | string | Status of E-way bill | ACT |
blkStatus | string | Block Status Possible value - B : BlockedU : Unblocked | B |
Response Caching
Response caching is not available for this API. Learn more about our response caching mechanism here
Wallet Charges
Since Generate E-Way Bill 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
Updated about 1 month ago