/verify/indian_gst

1.API Specification
2.Request Params
3.Response Params
4.Error Codes
5.Sample

1.API Specification

This API is used to authenticate 15 Digit GSTIN issued by the Goods and Service Tax Network in India. GSP stands for GST Suvidha Provider.

Request Method

POST

Request URL

https://cloudapi.accuauth.in/verify/indian_gst

Debugging Tool

Debugging Tool

Debugging Tool

2.Request Params

2.1 Request Header

Parameter Type Required Description
X-DF-API-ID string Yes For API credentials，Please visit API Request
X-DF-API-SECRET string Yes For API credentials，Please visit API Request

2.2 Request Body

Required Fields Type Description
required gstin string Unique GSTIN
required consent string This must be Y

3.Response Params

Fields Type Description
request_id string Unique id of each request
status string Response status, OK for success request, Error Codes for failed request
result_code integer Result code, see Result Codes for detail
result_message string Result message
result object The verfication result

3.1 Elements in result

Fields Type Description
mbr stringArray Member names if provided by GSP
can_flag string -
pradr object Primary business contact information including, pradr
trade_nam string Trade name
lstupdt string Last updated
contacted object See contacted
rgdt string Registration date under GST
stj_cd string State Jurisdiction Code
stj string State Jurisdiction
ctj_cd string Central Jurisdiction Code
ctj string Central Jurisdiction
ppr string -
dty string Taxpayer type
cmp_rt string Compliance rating if provided by GSP
cxdt string Date of cancellation of registration
ctb string Constitution of business (proprietorship, partnership, private limited company, public limited company etc)
sts string Current status of registration under GST
gstin string Given GSTIN
lgnm string Legal name of the business or individual corresponding to the GSTIN
nba stringArray Nature of business registered under GST
adadr objectArray Address information, adadr
3.1.1 Elements in pradr and adadr
Fields Type Description
em string Email ID
adr string Complete address
addr string Address
mb string Mobile number
ntr string Nature of business carried out at the address
last_updated_date string Last updated date of this address
3.1.2 Elements in contacted
Fields Type Description
mob_num string Mobile number
email string Email ID
name string Name

3.2 Result Code Description

Value Description Billable
101 Valid authentication Yes
102 Invalid ID number or combination of inputs Yes
103 No records found for the given ID or combination of inputs Yes
104 Max retries exceeded Yes
105 Missing Consent Yes
106 Multiple Records Found Yes
Response Syntax
{
    "status": "OK",
    "result_code": 101,
    "result_message": "Success",
    "result": {
        "mbr": [],
        "can_flag": "NA",
        "pradr": {
            "em": "",
            "adr": "xxxxxxx",
            "addr": "NA",
            "mb": "",
            "ntr": "xxxxxxxxxx",
            "last_updated_date": "NA"
        },
        "trade_nam": "xxxxxx xxxx xxxx",
        "lstupdt": "07/02/2020",
        "contacted": {
            "mob_num": null,
            "email": null,
            "name": null
        },
        "rgdt": "01/07/2017",
        "stj_cd": "xxxxxxx",
        "stj": "xxxxxxx",
        "ctj_cd": "xxxxx",
        "ppr": "NA",
        "dty": "Regular",
        "cmp_rt": "NA",
        "cxdt": "",
        "ctb": "Public Limited Company",
        "sts": "Active",
        "gstin": "xxxxxxxxxxx",
        "lgnm": "RELIANCE INDUSTRIES LIMITED",
        "nba": [
            "Factory / Manufacturing",
            "Retail Business",
            "Input Service Distributor (ISD)",
            "Bonded Warehouse",
            "SEZ",
            "Works Contract",
            "Warehouse / Depot",
            "Service Provision",
            "Leasing Business",
            "Office / Sale Office",
            "Recipient of Goods or Services",
            "Wholesale Business",
            "EOU / STP / EHTP",
            "Supplier of Services",
            "Others",
            "Export"
        ],
        "ctj": "RANGE-IV",
        "adadr": [
            {
                "em": "",
                "adr": "xxxxxxxx",
                "addr": "NA",
                "mb": "",
                "ntr": "xxxxxxxxx",
                "last_updated_date": "NA"
            }
        ]
    },
    "request_id": "TIDad53c5b2824a482597e96d75f9370cfb"
}

4.Error Codes

Common error codes of this API:

Http Status Code Status Field Description
400 INVALID_ARGUMENT Request parameter is invalid
400 QUERY_FAILED Query failed
400 ABNORMAL_BEHAVIOURS_DETECTED Request with same parameters repeated more than amount of times
401 UNAUTHORIZED Unauthorized or access is denied
401 KEY_EXPIRED Your API ID has expired
403 NO_PERMISSION You are not authorized to use this API
403 OUT_OF_QUOTA API calls quota exceeded
403 RATE_LIMIT_EXCEEDED API request frequency exceeds the limit
404 NOT_FOUND Requested API cannot be found
500 INTERNAL_ERROR Internal server error
512 SOURCE_SERVICE_UNAVAILABLE Source service is unavailable
513 SOURCE_SERVICE_TIMEOUT Source service is timeout

Comment: Please see the reason field for details when the above 40X / 51X error occurred

Response Syntax
{
  "status": "INVALID_ARGUMENT",
  "reason": "argument 'gstin': not found",
  "request_id": "TID8bf47ab6eda64476973cc5f5b6ebf57e"
}

5.Sample

results matching ""

    No results matching ""