POST
/
gstin
Verify GSTIN
curl --request POST \
  --url https://sandbox.cashfree.com/verification/gstin \
  --header 'Content-Type: application/json' \
  --header 'x-client-id: <api-key>' \
  --header 'x-client-secret: <api-key>' \
  --data '{
  "GSTIN": "29AAICP2912R1ZR",
  "business_name": "UJJIVAN SMALL FINANCE BANK"
}'
{
  "reference_id": 19,
  "GSTIN": "29AAICP2912R1ZR",
  "legal_name_of_business": "UJJIVAN SMALL FINANCE BANK LIMITED",
  "trade_name_of_business": "UJJIVAN SMALL FINANCE BANK",
  "center_jurisdiction": "I-A RANGE",
  "state_jurisdiction": "GUWAHATI - A - 1",
  "date_of_registration": "2017-09-30",
  "constitution_of_business": "Public Limited Company",
  "taxpayer_type": "Regular",
  "gst_in_status": "Active",
  "last_update_date": "2022-03-01",
  "nature_of_business_activities": [
    "Retail Business",
    "Supplier of Services",
    "Recipient of Goods or Services",
    "Office / Sale Office",
    "Others"
  ],
  "principal_place_address": "First Floor 3512-DISPUR Prithivi Mansion opp. KFC building G.S. Road, Lachit Nagar Assam 781007",
  "principal_place_split_address": {
    "building_name": "Prithivi Mansion",
    "street": "G.S. Road",
    "location": "Lachit Nagar",
    "building_number": "3512-DISPUR",
    "district": "Guwahati",
    "state": "Assam",
    "city": "Dispur",
    "flat_number": "First Floor",
    "latitude": "26.1445",
    "longitude": "91.7362",
    "pincode": "781007"
  },
  "additional_address_array": [
    {
      "address": "Mirza Santipur NH-37 Dist-Kamrup Rural PS-Palashbari, PO  Mirza Kamrup Assam 781125",
      "split_address": {
        "building_name": "",
        "street": "NH-37",
        "location": "Santipur, Mirza",
        "building_number": "",
        "district": "Kamrup Rural",
        "state": "Assam",
        "city": "Palashbari",
        "flat_number": "",
        "latitude": "26.0926",
        "longitude": "91.5069",
        "pincode": "781125"
      }
    },
    {
      "address": "N.A.C.C.I. Foundation 3559-Tezpur CHAMBER BHAWAN Binjraj Road, P. o. and P.S. - Tezpur, Dist. Binjraj Road, P. o. and P.S. - Tezpur, Dist. Sonitpur Assam 784154",
      "split_address": {
        "building_name": "CHAMBER BHAWAN",
        "street": "Binjraj Road",
        "location": "Tezpur",
        "building_number": "3559-Tezpur",
        "district": "Sonitpur",
        "state": "Assam",
        "city": "Tezpur",
        "flat_number": "",
        "latitude": "26.6338",
        "longitude": "92.8006",
        "pincode": "784154"
      }
    }
  ],
  "valid": true,
  "message": "GSTIN Exists"
}

Authorizations

​
x-client-id
string
header
required

Your unique client identifier issued by Cashfree. You can find this in your Merchant Dashboard.

​
x-client-secret
string
header
required

The secret key associated with your client ID. Use this to authenticate your API requests. You can find this in your Merchant Dashboard.

Headers

​
x-cf-signature
string

Send the signature if IP is not whitelisted.

Body

application/json

Find the request parameters to retrieve GSTIN information

The body is of type object.

Response

200
application/json

Success response for retrieving GSTIN information

The response is of type object.