1. Request Details

HTTP Method POST
URL PATH https://my.gstzen.in/api/gstin-validator/
Request Payload Type application/json
Response Type application/json
Authentication Type Token

2. Request Payload Example

Headers

Token f15da0e8-e4d0-11ed-b5ea-0242ac120002

You can find your GSTZen API key at bottom of your profile page.

Body

{
  "gstin":"01AAFQQ9980MZQR"
}

3. Response Example

With valid GSTIN

{
  "status": 1,
  "gstin": "01AAFQQ9980MZQR",
  "valid": true,
  "company_details": {
    "legal_name": "GSTZEN PRIVATE LIMITED",
    "trade_name": "GSTZEN PRIVATE LIMITED",
    "company_status": "Active",
    "pan": "AAFQQ9980M",
    "state": "29 - Karnataka KA",
    "state_info": {
      "code": "29",
      "name": "Karnataka",
      "alpha_code": "KA"
    },
    "registration_date": "2017-07-01",
    "gst_type": "Regular",
    "adadr": [
      {
        "addr": "1ST FLOOR, 10, INQ BUILDING, FORT, KARNATAKA, 560082",
        "loc": "FORT",
        "pincode": "560082",
        "street": "10, VEER NARIMAN ROAD"
      },
      {
        "addr": "4ST FLOOR, 10, ESTEEM FORT, HOND, KARNATAKA, 560078",
        "loc": "HOND",
        "pincode": "560078",
        "street": "12, SIMHA ROAD"
      }
    ],
    "pradr": {
      "addr": "4TH FLOOR, 5, KATGARA HOUSE, YELLAMMA HILL, Karnataka, 560082",
      "loc": "YELLAMMA HILL",
      "pincode": "560082",
      "street": "15, L JAGMOHANDAS Dinne Main Road"
    }
  }
}

With invalid GSTIN

{
  "status": 1,
  "gstin": "01AAFQQ9980MZQR",
  "valid": false
}

With Subscription Limit Exhausted

{
  "status": 0,
  "message": "Your GSTZen GSTIN Validator Subscription has exhausted. Current usage: 100000, Total Subscription
  Package: 10000. Please contact GSTZen support."
}

With Subscription Perior Expired

{
  "status": 0,
  "message": "Your GSTZen GSTIN Validator Subscription has expired. Please contact GSTZen support."
}

FAQ

1. What will happen if I pass multiple GSTIN?
   API offers to validate only one GSTIN at a time. If multiple string are passed to the API, only the first will be considered for the validation process.

Have more questions? Connect with us with links provided in footer.