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/search

https://api-preproduction.signzy.app/api/v3/ptrc/search

Request 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!