Confirm GSTR-1A / IFF Liability Declaration
POST
https://apisandbox.whitebooks.in/gstr1a/confirmdeclarationThis API is used to confirm the GSTR1/GSTR1A/IFF Liability Details.
Parameters
query parameters
gstinstringrequiredGSTIN of the taxpayer
retperiodstringrequiredReturn Period
emailstringrequiredEmail
header parameters
gst_usernamestringrequiredGST UserName
state_cdstringrequiredState Code
ip_addressstringrequiredIP Address
txnstringrequiredTransaction
client_idstringrequiredClient ID
client_secretstringrequiredClient Secret
Request Body
application/jsonrequired
gstinstringoptionalGSTIN
Example: "32CHAND3868A1Z3"
ret_periodstringoptionalReturn Period
Example: "092024"
r2bStaleStatusstringoptionalGSTR2B Stale Status
Example: "N"
chksumstringoptionalCheckSum of the payload
Example: "0b194f5f9cfeb178a4d1440103641b81eb17728b9afd6691a3661aa9c3dd0f8d"
liabobjectoptionalgstr1Liabobjectoptionalsec_nmstringoptionalGSTR1 Liability Section Name
Example: "TTL_LIAB_GSTR1"
chksumstringoptionalGSTR1 Liablity Check sum value
Example: "da88731791fdf49c66735228563c4bc798f0af67ba0d1a7089c94762e9f724a6"
ttl_taxnumberoptionalTotal taxable value of records
Example: 2000
ttl_igstnumberoptionalIGST Amount
Example: 10
ttl_cgstnumberoptionalCGST Amount
Example: 0
ttl_sgstnumberoptionalSGST Amount
Example: 0
ttl_cessnumberoptionalTotal Tax Paid CESS
Example: 0
ttl_valnumberoptionalSGST Amount
Example: 10
iffLiabarray<object>optionalArray items:
sec_nmstringoptionalIFF Liability Section Name
Example: "TTL_LIAB_IFF"
chksumstringoptionalIFF Liablity Check sum value
Example: "da88731791fdf49c66735228563c4bc798f0af67ba0d1a7089c94762e9f724a6"
iff_ret_periodstringoptionalIFF Return Period
Example: "042024"
ttl_taxnumberoptionalTotal taxable value of records
Example: 2000
ttl_igstnumberoptionalIGST Amount
Example: 10
ttl_cgstnumberoptionalCGST Amount
Example: 0
ttl_sgstnumberoptionalSGST Amount
Example: 0
ttl_cessnumberoptionalTotal Tax Paid CESS
Example: 0
ttl_valnumberoptionalSGST Amount
Example: 10
gstr1aLiabobjectoptionalsec_nmstringoptionalGSTR1A Liability Section Name
Example: "TTL_LIAB_GSTR1A"
chksumstringoptionalGSTR1A Liablity Check sum value
Example: "da88731791fdf49c66735228563c4bc798f0af67ba0d1a7089c94762e9f724a6"
ttl_taxnumberoptionalTotal taxable value of records
Example: 2000
ttl_igstnumberoptionalIGST Amount
Example: 10
ttl_cgstnumberoptionalCGST Amount
Example: 0
ttl_sgstnumberoptionalSGST Amount
Example: 0
ttl_cessnumberoptionalTotal Tax Paid CESS
Example: 0
ttl_valnumberoptionalSGST Amount
Example: 10
balobjectoptionalcash_balobjectoptionalchksumstringoptionalCheck sum of Object
Example: "da88731791fdf49c66735228563c4bc798f0af67ba0d1a7089c94762e9f724a6"
igst_balnumberoptionalIGST Amount
Example: 10
cgst_balnumberoptionalCGST Amount
Example: 0
sgst_balnumberoptionalSGST Amount
Example: 0
cess_balnumberoptionalCESS Amount
Example: 0
ttl_balnumberoptionalSGST Amount
Example: 10
itc_balobjectoptionalchksumstringoptionalCheck sum of Object
Example: "da88731791fdf49c66735228563c4bc798f0af67ba0d1a7089c94762e9f724a6"
igst_balnumberoptionalIGST Amount
Example: 10
cgst_balnumberoptionalCGST Amount
Example: 0
sgst_balnumberoptionalSGST Amount
Example: 0
cess_balnumberoptionalCESS Amount
Example: 0
ttl_balnumberoptionalSGST Amount
Example: 10
gstr2b_itc_balobjectoptionalchksumstringoptionalCheck sum of Object
Example: "da88731791fdf49c66735228563c4bc798f0af67ba0d1a7089c94762e9f724a6"
igst_balnumberoptionalIGST Amount
Example: 10
cgst_balnumberoptionalCGST Amount
Example: 0
sgst_balnumberoptionalSGST Amount
Example: 0
cess_balnumberoptionalCESS Amount
Example: 0
ttl_balnumberoptionalSGST Amount
Example: 10
Response
Not Found. If requested entity is not found or if requested API is not found.
Frequently Asked Questions
The body requires a
sec_sum object containing liability summary (liab_sum) and differential amounts (diff_sum) with IGST, CGST, SGST, and CESS breakdowns — and a bal object with current cash_bal, itc_bal, and gstr2b_itc_bal ledger amounts including their checksums.The checksum values in
liab_sum.chksum, cash_bal.chksum, etc. are SHA-256 hashes of the corresponding data objects generated by GSTN. Retrieve them from the GET /gstr1a/getdeclaration response and pass them back verbatim in the confirmation payload.No. The confirmation is a single atomic call that locks all declared liability and ledger sections simultaneously. You must include all the summary and balance objects returned from GET /gstr1a/getdeclaration.
A successful confirmation commits the GSTR-1A/IFF liability state on GSTN and returns an acknowledgement. The confirmed declaration is a prerequisite for the subsequent return filing step. No further amendments can be made after confirmation in the same return period.
No example available.