Skip to main content
PUT
Update GST configuration

Body Parameters

Example Request

Response

Notes

  • The gstin format is validated against the standard 15-character pattern: 2 digits (state code) + 10 characters (PAN) + 1 digit (entity number) + 1 character (Z) + 1 check digit.
  • Changing the state_code will affect CGST/SGST vs IGST calculations on all future invoices.
  • This endpoint does not control einvoice_enabled. Use the IRP Configuration endpoint to manage e-invoicing settings.
Updating GST configuration applies to all future invoices. Existing finalized invoices are not retroactively modified.

Authorizations

Authorization
string
header
required

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

Query Parameters

entity_id
string<uuid>

Legal entity to scope the tax config to (Multi-Entity Books). Omit for the tenant's primary entity / default config.

Body

application/json
gstin
string
Required string length: 15
state_code
string

Two-digit Indian state code (derived from the GSTIN when omitted).

state_name
string
sac_code
string
Example:

"998314"

gst_rate
number
Example:

18

pan
string
trade_name
string
address
string
has_lut
boolean

Letter of Undertaking on file (zero-rated exports).

Response

Configuration saved.

data
object
message
string