GST APIEnvironment:
Default OTP575757
API Reference
Overview
Public
Authentication
GSTR
GSTR1
GSTR1A
Get GSTR1A SummaryGET
Get GSTR1A Document IssuedGET
Get CDNRA InvoicesGET
Get B2CL InvoicesGET
Get B2BA InvoicesGET
Get ATAGET
Get TXPGET
Get Supplier ECO invoicesGET
Get Supplier ECOA invoicesGET
Get ECOM InvoicesGET
Get ECOMA InvoicesGET
Save GSTR1A dataPUT
Get B2B InvoicesGET
Get B2CLA InvoicesGET
Get B2CSA InvoicesGET
Get CDNR InvoicesGET
Get ATGET
Get EXPAGET
Get B2CS InvoicesGET
Get EXPGET
Get Nil Rated SuppliesGET
Get HSN Summary detailsGET
API call for getting all Credit/ Debit Notes issued to un-registered persons for a return period.GET
API call for getting all amended Credit/ Debit Notes issued to un-registered persons for a return period.GET
Reset GSTR1A DataPOST
File GSTR1A dataPOST
File GSTR1A dataPOST
Proceed To FileGET
Get TXPAGET
Get Declaration DetailsGET
Confirm Declaration DetailsPOST
GSTR2A
GSTR2B
GSTR2X
GSTR3B
GSTR4
GSTR4A
GSTR4Annual
GSTR5
GSTR6
GSTR6A
GSTR7
GSTR8
GSTR9
GSTR9A
GSTR9C
SPIKE
ALL
IMS
ITC03
ITC04
CMP
Payment
Ledger
e-Invoice
Notices

GSTR-1A, GSTR-1 and IFF Liability Declaration Details

GEThttps://apisandbox.whitebooks.in/gstr1a/getdeclaration

This API is used to view the GSTR1 , GSTR1A and IFF Liability details along with Available ITC ,Cash Ledger details and ITC Available as per GSTR2B Details.

Parameters

query parameters
gstinstringrequired
GSTIN of the taxpayer
retperiodstringrequired
Return Period
emailstringrequired
Email
header parameters
gst_usernamestringrequired
GST UserName
state_cdstringrequired
State Code
ip_addressstringrequired
IP Address
txnstringrequired
Transaction
client_idstringrequired
Client ID
client_secretstringrequired
Client Secret

Response

Not Found. If requested entity is not found or if requested API is not found.

Frequently Asked Questions

The endpoint returns GSTR-1, GSTR-1A, and IFF liability details including section-wise tax summaries, available ITC (from GSTR-2B), cash ledger balances, and the differential amounts between GSTR-1 and GSTR-1A data — used to review pre-confirmation liability state.
Mandatory query parameters: gstin, retperiod (MMYYYY format), email. Mandatory headers: gst_username, state_cd, ip_address, txn, client_id, client_secret. An active GST portal session (txn) is required.
Call this endpoint after any amendments have been entered into GSTR-1A but before confirming the declaration. It gives you the full liability picture so you can verify that liabilities, ITC, and ledger balances are correct before committing via POST /gstr1a/confirmdeclaration.
The retperiod query parameter must follow MMYYYY format, for example 102026 for October 2026. Supplying an incorrect format returns a validation error.
GET/gstr1a/getdeclaration
1const response = await fetch('https://apisandbox.whitebooks.in/gstr1a/getdeclaration?gstin=value&retperiod=value&email=value', {
2 method: 'GET',
3 headers: {
4 gst_username: "value",
5 state_cd: "value",
6 ip_address: "value",
7 txn: "value",
8 client_id: "value",
9 client_secret: "value"
10},
11});
12
13const data = await response.json();
14console.log(data);
No example available.