New contracts for GST Public and Taxpayer API

New API contracts for GST Public APIs and GST Taxpayer APIs have been published along with improvements and bug fixes.

New contracts

Change in endpoints

At a high level, the endpoints have changed in the fashion below. However, for specific APIs, please refer to the API reference for complete details.

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.