PTRC (Professional Tax Registration Certificate) API
Introduction
This API allows you to retrieve comprehensive details associated with a Professional Tax Number. By inputting a valid Professional Tax Number, the API returns detailed information including the state, dealer name, tax identification numbers (TIN and GSTIN), address details, and related GSTN data. This facilitates efficient verification and integration of professional tax data into your applications or workflows.
API details
Endpoint
https://api.signzy.app/api/v3/ptrc/searchhttps://api-preproduction.signzy.app/api/v3/ptrc/searchRequest Headers
Name | Value | Required | Description |
|---|---|---|---|
Content-type | application/json | Mandatory | The type of content that the request body contains. |
Authorization | XXXXXXXXXXXXXXX | Mandatory | An authentication token to authorize the request. Reach out to the Signzy support team to get one created. |
Request body parameters
Parameter | Type | Description |
|---|---|---|
professionalTaxNumber state | string string | A unique identifier assigned to individuals or entities for tax purposes. State where the user stays. |
{
"professionalTaxNumber":"<professionalTaxNumber>",
"state":"<state>"
}Code samples
curl --location 'https://api-preproduction.signzy.app/api/v3/ptrc/search' \
--header 'Content-Type: application/json' \
--header 'Authorization: <auth token>' \
--data '{
"professionalTaxNumber":"<professionalTaxNumber>",
"state":"<state>"
}'Response body parameters
Parameter | Data Type | Description |
|---|---|---|
result | Object | Contains detailed information about the entity. |
result.address1 | String | First line of the address. |
result.address2 | String | Second line of the address. |
result.address3 | String | Third line of the address. |
result.talukaName | String | Name of the taluka (sub-district). |
result.streetName | String | Name of the street. |
result.pinCode | String | Postal code. |
result.districtName | String | Name of the district. |
result.cityName | String | Name of the city. |
result.effectiveOrCanceledDate | String | Effective or canceled date. |
result.address | String | Complete address. |
result.status | String | Status of the entity. |
result.tin | String | Taxpayer identification number. |
result.principalAddress | String | Principal address of the entity. |
result.dealerStatus | String | Status of the dealer. |
result.gstin | String | Goods and Services Tax Identification Number (GSTIN). |
result.dealerName | String | Name of the dealer. |
result.splitAddress | Object | Contains split address information. |
result.dataFromGstn | Object | Contains data retrieved from GSTN (Goods and Services Tax Network). |
result.dataFromGstn.gstnDetailed | Object | Detailed information retrieved from GSTN. |
result.dataFromGstn.gstnRecords | Array | Records retrieved from GSTN. |
{
"professionalTaxNumber": "99522311536P",
"state": "MAHARASHTRA",
"id": 11,
"result": {
"address1": "",
"address2": "",
"address3": "",
"talukaName": "",
"streetName": "",
"pinCode": "",
"districtName": "",
"cityName": "",
"effectiveOrCanceledDate": "",
"address": "",
"status": "",
"state": "MAHARASHTRA",
"tin": "099522311536",
"principalAddress": "",
"dealerStatus": "",
"gstin": "",
"dealerName": "ADDTEQ SOFTWARE INDIA PVT LTD",
"splitAddress": {
"district": [],
"state": [
[]
],
"city": [],
"pincode": "",
"country": [
"IN",
"IND",
"INDIA"
],
"addressLine": ""
},
"dataFromGstn": {
"gstnDetailed": {
"constitutionOfBusiness": "",
"legalNameOfBusiness": "",
"tradeNameOfBusiness": "",
"centreJurisdiction": "",
"stateJurisdiction": "",
"registrationDate": "",
"taxPayerDate": "",
"gstinStatus": "",
"cancellationDate": "",
"natureOfBusinessActivities": [],
"principalPlaceAddress": "",
"principalPlaceBuildingNoFromGST": "",
"principalPlaceBuildingNameFromGST": "",
"principalPlaceFlatNo": "",
"additionalPlaceAddress": "",
"additionalPlaceBuildingNoFromGST": "",
"additionalPlaceBuildingNameFromGST": "",
"additionalPlaceFlatNo": "",
"additionalPlaceSplitAddress": {
"district": [],
"state": [
[]
],
"city": [],
"pincode": "",
"country": [],
"addressLine": ""
},
"principalPlaceSplitAddress": {
"district": [],
"state": [
[]
],
"city": [],
"pincode": "",
"country": [],
"addressLine": ""
}
},
"gstnRecords": [
{
"applicationStatus": "",
"registrationName": "",
"mobNum": "",
"regType": "",
"emailId": "",
"tinNumber": "",
"gstinRefId": "",
"gstin": ""
}
],
"gstin": ""
}
}
}Contact Us for Any Assistance
If you have any questions or need assistance, please reach out to our customer support team. You can contact us via email at [email protected]. We strive to provide prompt and reliable assistance, ensuring your queries are addressed effectively.
We value your feedback and are committed to making your experience smooth and enjoyable. Our team is dedicated to assisting you with any needs you may have. Thank you for choosing our services. We look forward to helping you!