GST split calculator API reference

GST split calculator

Calculates GST and splits it into CGST + SGST/UTGST or IGST.

Endpoint

POST https://api.finovel.in/v1/gst-split

Charged only when the call succeeds. Errors are never charged. See how every API works for keys, retries and status codes.

Request fields

Field	Type	Required	Description
`amount`	decimal	Yes	Taxable amount (₹)
`rate`	decimal	Yes	GST rate (%)
`supplier`	text	Yes	Supplier GSTIN or state
`recipient`	text	Yes	Recipient GSTIN or state
`recipient_sez`	checkbox	No	Recipient is in an SEZ

Example request

curl -X POST https://api.finovel.in/v1/gst-split \
  -H "Authorization: Bearer fin_test_your_key" \
  -H "Content-Type: application/json" \
  -d '{"amount":"10000","rate":"18","supplier":"Maharashtra","recipient":"Karnataka"}'

Response fields

Inside data:

Field	Description
`treatment`	Treatment
`gst_amount`	GST
`cgst`	CGST
`sgst`	SGST
`utgst`	UTGST
`igst`	IGST
`total_amount`	Total

Example response from the sandbox

{
  "request_id": "req_...",
  "success": true,
  "status": "success",
  "environment": "sandbox",
  "message": "OK",
  "data": null,
  "error": null,
  "charged_paise": 0
}