Skip to main content
POST
Validate a GSTIN

Body Parameters

Example Request

Response

Response Fields

Notes

  • If the GSTIN format is invalid, the response returns valid: false with a 400 status code.
  • This endpoint queries the GST Network (GSTN) portal in real-time. Responses may take 2-3 seconds during peak hours.
Use this endpoint to validate customer GSTINs before saving them to avoid incorrect tax calculations on invoices.

Authorizations

Authorization
string
header
required

Tenant API key obtained from POST /auth/register or POST /v1/developer/keys.

Body

application/json
gstin
string
Required string length: 15

Response

Validation result (returned for both valid and invalid GSTINs).

valid
boolean
state_code
string

Present when valid.

state_name
string

Present when valid.

pan
string

Present when valid.

message
string