New contracts for GST Public and Taxpayer API

We have deployed new API contracts for GST Public APIs and GST Taxpayer APIs. Consequently, the previous contracts have been deprecated. Improvements and bug fixes also pushed with the same.

New contracts

Change in endpoints

GST API	New endpoint	Deprecated endpoint
Public	{sandbox_host}/gst/compliance/public/{endpoint}	{sandbox_host}/gsp/public/{endpoint}
Taxpayer	{sandbox_host}/gst/compliance/tax-payer/{endpoint}	{sandbox_host}/gsp/tax-payer/{endpoint}

Change in response

The new contracts have a change in the response nesting.

{
    "transaction_id": "28828716-0e9c-4af8-94da-5367fa8c679d",
    "code": 200,
    "data": {
        "data": {
            "ack_num": "ASDFSDF1241343"
        },
        "status_cd": 1
    },
    "timestamp": 1621510445676
}

{
    "transaction_id": "28828716-0e9c-4af8-94da-5367fa8c679d",
    "code": 200,
    "data": {
        "ack_num": "ASDFSDF1241343"
    },
    "timestamp": 1621510445676
}

POST to GET

Some API contracts have changed as per our thought-process about which you can read here. Below APIs have changed as per our design choice.

Improvements

Change in issuer for Taxpayer access token

Issuer has been changed to "gst.gov.in" in the Taxpayer access token.

GSTIN transformation

GSTIN passed in lowercase will be transformed to uppercase and then request will be executed.

Bug Fixes

Taxpayer access token: Wrong expiry has been corrected.

Deprecation of old contracts

The old contracts have been deprecated and will be discontinued soon. Timelines will be communicated.