Search GSTIN
Goods and Service Tax Identification Number (GSTIN) is a unique 15-digit number issued to businesses registered under GST. Businesses can verify GSTIN using Sandbox API
Overview
The API takes in gstin of a registered business and provides you with their information as available on the GST Portal.
Problem
- GSTIN verification is important for businesses as part of their KYC process
- Businesses can only verify one GSTIN at a time by visiting the GST portal.
Solution
- The Search GSTIN API provides the necessary data to automate the KYC of GST-registered businesses
Endpoint
| HTTP Method | Resource | Description |
|---|---|---|
GET | /gsp/public/gstin/:gstin | Returns GSTIN entity for given GSTIN |
Request
Follow the below guidelines to pass GSTIN for verification.
Path Parameters
| Param | Type | Description | Example |
|---|---|---|---|
| gstin | string | 15-character alphanumeric unique identifier assigned to business entities registering under the GST regime | 24AAACJ3770E2ZV |
Sample CURL request
curl --location --request GET 'https://api.sandbox.co.in/gsp/public/gstin/24AAACJ3770E2ZZ' \
--header 'Authorization: eyJhbGciOiJIUzUxMiJ9.eyJhdWQiOiJBUEkiLCJyZWZyZXNoX3Rva2VuIjoiZXlKaGJHY2lPaUpJVXpVeE1pSjkuZXlKaGRXUWlPaUpCVUVraUxDSnpkV0lpT2lKclpYbGZiR2wyWlY5QlpHVXFLaW9xS2lvcUtpb3FLaW9xS2lvcUtpb3FLaW9xS2lvcUtsVjRjeUlzSW1Gd2FWOXJaWGtpT2lKclpYbGZiR2wyWlY5QlpHVXFLaW9xS2lvcUtpb3FLaW9xS2lvcUtpb3FLaW9xS2lvcUtsVjRjeUlzSW1semN5STZJbUZ3YVM1eGRXbGphMjh1WTI5dElpd2laWGh3SWpveE5Ua3dPVFk1TmpBd0xDSnBiblJsYm5RaU9pSlNSVVpTUlZOSVgxUlBTMFZPSWl3aWFXRjBJam94TlRVNU16UTNNakF3ZlEueHNmYkhQTERFRlRvTy1OUWdaUUpLM25OUjFxdlhvWmhaOHRqS3gzSExydjZiVkJaMHpJZEZ5ai1MUTg1YnJZS0xXQnFnZHlzZ1NDSXlDUXNtV2VOYkEiLCJzdWIiOiJqb2huQGRvZS5jb20iLCJhcGlfa2V5Ijoia2V5X2xpdmVfQWRlKioqKioqKioqKioqKioqKioqKioqKioqKipVeHMiLCJpc3MiOiJhcGkucXVpY2tvLmNvbSIsImV4cCI6MTU5MTA1NjAwMCwiaW50ZW50IjoiQUNDRVNTX1RPS0VOIiwiaWF0IjoxNTkwOTY5NjAwfQ.nH23CR5RHGQ0U19I_vq3vyJ_85A1a2iEMQij5QHgJQdDuS9x7FmTidsr1CQabSFF5ujE40SFxHv1gJM20TauUw' \
--header 'x-api-key: key_live_Ade**************************Uxs' \
--header 'x-api-version: 3.4.0'
Test Environment Available
Response
The response would have the following information
| Param | Type | Description | Example |
|---|---|---|---|
| ctb | string | Constitution of Business | Private Limited Company |
| ctj | string | Centre Jurisdiction | RANGE I |
| ctjCd | string | Centre Jurisdiction Code | WS0601 |
| cxdt | string | Date Of Cancellation | |
| dty | string | Taxpayer type | Regular |
| einvoiceStatus | string | Status of e-Invoice | No |
| gstin | string | GSTIN of the entity | 24AAACJ3770E2ZV |
| lgnm | string | Legal Name of Business | JOHN DOE PRIVATE LIMITED |
| lstupddt | string | Last Updated Date | 14/04/2018 |
| nba | string | Nature of Business Activity | Service Provision |
| rgdt | string | Date of Registration | 01/07/2017 |
| stj | string | State Jurisdiction | Ghatak 9 (Ahmedabad) |
| stjCd | string | State Jurisdiction Code | GJ009 |
| sts | string | GSTN status | Active |
| tradeNam | string | Trade Name | John Doe Private Limited |
| adadr | string | Additional Place of Business Fields | [] |
| pradr | object | Pricipal Place of Business fields | Look Below  |
| addr | object | Pricipal Place of Business Address | Look Below |
| bnm | object | Building Name | ABC Lakeview Tower |
| bno | string | Door Number | 123 |
| dst | string | District | Ahmedabad |
| flno | string | Floor Number | 1 |
| geocodelvl | string | Geo Code Level | NA |
| landMark | string | Landmark | - |
| lg | string | Longitude | 1231223121 |
| loc | string | Location | Vastrapur |
| locality | string | Locality | |
| lt | string | Lattitude | 1231231231 |
| pncd | string | Pin Code | 380015 |
| st | string | Street | Opp. Vastrapur Lake |
| stcd | string | State name | Gujarat |
| ntr | string | Nature of pricipal place of Business | Service Provision |
| einvoiceStatus | string | Status of e-Invoicing | No |
Response Caching
Response caching is not available for this API. Learn more about our response caching mechanism here
Wallet Charge
Since Search GSTIN is a Paid APIs, a wallet charge of INR 0.25 + GST per API call will be applicable.
Versioning
This API is currently in major version 1.0. Refer to the below table for the versioning history of this API along with the Changelog.
| Version | Description | Endpoint |
|---|---|---|
| 1.0 | This is the first version of the API | |
Refer to our versioning policies here
Updated 6 days ago