B2B Leads - GST Registered Company Contact API
API TO FETCH CONTACT INFORMATION INCLUDING EMAIL AND MOBILE NUMBER OF COMPANIES REGISTERED ON GSTIN NETWORK
Powered by Attestr. Visit product page for details.
Description
Unlock verified B2B leads with our GST Registered Company Contact API. Instantly fetch accurate contact details, including company email IDs, mobile numbers, and key business information, directly from the GSTIN network. Our API empowers sales, marketing, and compliance teams to access updated GST-linked company data for lead generation, business verification, and outreach at scale. Start connecting with genuine, GST-verified businesses today and accelerate your B2B growth.
API Details
Request
| Type | URL | Current Version |
|---|---|---|
| POST | https://api.attestr.com/api/{version}/public/leadx/gstin-contact | v2 |
Request Body Parameters
| Key | Type | Description | Optional (default) | Min Version | Max Version |
|---|---|---|---|---|---|
| reg | String | Input GSTIN | Required | v2 |
Sample Request Body
{ "reg": "36AAJCP3063A1ZQ"}Request Header Parameters
| Type | Name | Value / Description | Optional | Min Version | Max Version |
|---|---|---|---|---|---|
| String | Content-Type | application/json | Required | v2 | |
| String | Authorization | Basic {authToken} | Required | v2 |
If you do not have the authentication token, please refer to Register App to generate one.
Response
HTTP Status 200
| Key | Description | Type | Min Version | Max Version |
|---|---|---|---|---|
| valid | Boolean flag indicating if the provided DIN is valid | Boolean | v2 | |
| status | Possible values are NOT_AVAILABLE and SUCCESS depending on if the contact information is available | String | v2 | |
| items | List of contacts linked to the provided company. See definition of the object below. | Array <ContactInfo> | v2 |
ContactInfo Object
| Key | Description | Type | Min Version | Max Version |
|---|---|---|---|---|
| mobileNumber | mobile number as registered | String | v2 | |
| emailAddress | email address as registered | String | v2 | |
| address | Address as registered | String | v2 |
Sample Response
Sample for successful contact fetch
{ "valid": true, "status": "SUCCESS", "items": [ { "mobileNumber": "+911234567890", "emailAddress": "gitanjali.raheja@attestr.com", "address": "3-1-764/1 Pathola Gate, Kachiguda, Kachiguda, Himayathnagar,, Telangana, India, 500027" }, { "mobileNumber": "+912234567890", "emailAddress": "prakash.raheja@attestr.com", "address": "8-2-293/K/57/101 Hyderabad, Telangana, India, 500073" } ]}Sample response for the case when data is not available with Attestr
{ "valid": false, "status": "NOT_AVAILABLE", "message": "Data not available"}Error Response
| Parameter | Type | Description |
|---|---|---|
| code | Number | Unique error codes for different errors. Always available. |
| message | String | Error message describing the error. Always Available. |
| details | String | Detail error message. Available only for certain types of errors. |
Error Codes
| HTTP Status | Error Code | Error Message |
|---|---|---|
| 400 | 4001 | Malformed data or missing required parameter values |
| 400 | 4005 | Operation could not be performed due to low credits balance |
| 401 | 4016 | Invalid client authorization |
| 403 | 4031 | Unauthorized access |
| 403 | 4035 | Requested service is not provisioned for your account |
| 403 | 4039 | Client's IP address is not whitelisted |
| 403 | 4035 | Requested service is not provisioned for your account |
| 429 | 4291 | Maximum account rate limit exceeded |
| 429 | 4292 | Maximum API rate limit exceeded |
| 429 | 4293 | Maximum account daily limit exceeded |
| 429 | 4294 | Maximum API daily limit exceeded |
| 500 | 5001 | Request could not be processed |
Sample Error Response
{ "code": 4001, "message": "Malformed data or missing required parameter values"}