Central Service Tax

6 min

Introduction

This endpoint allows users to retrieve central service tax information for a given assessee code.

Sample Curl

curl --request POST \
  --url 'http://preproduction.signzy.tech/api/v2/patrons/..your-patron-id../centralservicetax' \
  --header 'Accept: */*' \
  --header 'Accept-Language: en-US,en;q=0.8' \
  --header 'Authorization: <Access-Token>' \
  --header 'content-type: application/json' \
  --data '{"essentials":{"assesseeCode":".....assessee code to search for...."}}'

Input Parameters

Parameter	Type	Required	Description
url	string	Yes	The URL of the endpoint to retrieve central service tax information.
method	string	Yes	The HTTP method for the request, which should be POST.
Accept	string	Yes	The media types that are acceptable for the response.
Accept-Language	string	Yes	The preferred natural language for the response.
Authorization	string	Yes	The access token that is used to authenticate the request.
content-type	string	Yes	The media type of the request payload, which should be JSON.
essentials.assesseeCode	string	Yes	The unique code for the assessee whose central service tax information is being requested.

Sample Response

{
    "essentials": {
      "assesseeCode": "...assesseeCode..."
    },
    "id": "...accessToken...",
    "patronId": "...patronId...",
    "result": {
      "divisionCode": "...divisionCode...",
      "nameOfAssessee": "...nameOfAssessee...",
      "status": "....status...",
      "locationCode": "...location...",
      "addressOfAssessee": "...address....",
      "assesseeBelongsTo": "SERVICE TAX",
      "commissionerateCode": ".....commissionerate code...",
      "rangeCode": "...range code....",
      "splitAddress": {
        "state": [
          []
        ],
        "district": [],
        "city": [],
        "pincode": "...pincode...",
        "country": [
          "IN",
          "IND",
          "INDIA"
        ],
        "addressLine": "...addressLine..."
      }
    }
  }

Output Parameters

Parameter	Description
essentials.assesseeCode	The code associated with the assessee
id	The access token generated for the request
patronId	The ID of the patron who made the request
result.divisionCode	The division code associated with the assessee
result.nameOfAssessee	The name of the assessee
result.status	The status of the assessee
result.locationCode	The location code associated with the assessee
result.addressOfAssessee	The address of the assessee
result.assesseeBelongsTo	The type of assessee (in this case, "SERVICE TAX")
result.commissionerateCode	The commissionerate code associated with the assessee
result.rangeCode	The range code associated with the assessee
result.splitAddress.state	The state(s) associated with the assessee address
result.splitAddress.district	The district(s) associated with the assessee address
result.splitAddress.city	The city(ies) associated with the assessee address
result.splitAddress.pincode	The pincode associated with the assessee address
result.splitAddress.country	The country(s) associated with the assessee address
result.splitAddress.addressLine	The address line associated with the assessee address

Status Codes

CODE	MESSAGE
200	OK
404	Not found
400	Invalid Data