New contracts for GST E-Way Bill API

New API contracts for GST E-Way Bill API 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.

{`

`}

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.

• E-Way Bill Authentication
• Search GSTIN Details

{`

`}

Improvements

Schema validation

As a high number of requests are invalid as per NIC schemas, we have enabled schema validation on the E-Way Bill APIs. The API which will return Invalid request body if request body does not match the schema. We have added the schemas on our E-Way Bill APIs documentation for reference.

How to validate the request body with schema

1. Go to JSON Schema Validator.
2. Copy the schema from API reference page and paste in the Select Schema box (left).
3. Paste your request body in the Input JSON box (right).
4. The validator will show you errors if any. Change the request body accordingly until no errors are found.

{`

`}

Change in issuer for E-Way Bill access token

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

{`

`}

GSTIN transformation

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

{`

`}

Bug Fixes

• E-Way Bill access token: Wrong expiry has been corrected.