Get GSTIN Details

You can use this API to get the GSTIN details

Request URL

GET: {{HOST}}​/einv/v1/govt/api/Master/gstin/{{gstin}}

Request Headers

Parameter	Type	Description
x-cleartax-auth-token	String	Mandatory. The access token generated for the workspace.
x-cleartax-product	String	Should always be "EInvoice" without the double quotes.
gstin	String	Users GSTIN

Request Parameters:

Parameters	Parameter Type	Type	Description
gstin	Path	String	GSTIN number

Sample Response

Valid Response

{
    "gstin": "29AAFCD5862R000",
    "tradeName": null,
    "legalName": "DEFMACRO SOFTWARE PRIVATE LIMITED",
    "buildingName": null,
    "buildingNumber": null,
    "floorNumber": null,
    "street": null,
    "location": null,
    "stateCode": "29",
    "pincode": "518001",
    "taxpayerType": null,
    "status": "ACTIVE",
    "ewbGenerationStatus": null,
    "errorDetails": null
}

Invalid Response

{
    "gstin": null,
    "tradeName": null,
    "legalName": null,
    "buildingName": null,
    "buildingNumber": null,
    "floorNumber": null,
    "street": null,
    "location": null,
    "stateCode": null,
    "pincode": null,
    "taxpayerType": null,
    "status": null,
    "ewbGenerationStatus": null,
    "errorDetails": {
        "errors": [
            {
                "error_code": "3001",
                "error_message": "Requested data is not available",
                "error_source": "GOVT"
            }
        ]
    }
}