GST APIEnvironment:
Default OTP575757
API Reference
Overview
Public
Authentication
GSTR
GSTR1
GSTR1A
GSTR2A
GSTR2B
GSTR2X
GSTR3B
GSTR4
GSTR4A
GSTR4Annual
GSTR5
Get B2B InvoicesGET
Get B2BA InvoicesGET
Get CDNR InvoicesGET
Get CDNRA InvoicesGET
Get IMPG InvoicesGET
Get IMPGA InvoicesGET
Get IMPS InvoicesGET
Get IMPSA InvoicesGET
Save GSTR5 dataPUT
Get CDNA UnregisteredGET
Get GSTR5 SummaryGET
SubmitPOST
File GSTR5POST
File GSTR5 dataPOST
Get B2CL InvoicesGET
Get B2CS InvoicesGET
Get CDN UnregisteredGET
Get Tax LiabGET
Offset Liability GSTR5 dataPUT
Get B2CLA InvoicesGET
Get B2CSA InvoicesGET
GSTR6
GSTR6A
GSTR7
GSTR8
GSTR9
GSTR9A
GSTR9C
SPIKE
ALL
IMS
ITC03
ITC04
CMP
Payment
Ledger
e-Invoice
Notices
GST APIGSTR5File GSTR5

File GSTR5

POSThttps://apisandbox.whitebooks.in/gstr5/retfile

This API is to submit the GSTR5 return.

Parameters

query parameters
emailstringrequired
API Developer User Email
header parameters
gstinstringrequired
GST Number
ret_periodstringrequired
Return Period (MMYYYY)
gst_usernamestringrequired
GST UserName
state_cdstringrequired
State Code
ip_addressstringrequired
IP Address
txnstringrequired
Transaction
client_idstringrequired
Client ID
client_secretstringrequired
Client Secret

Request Body

application/jsonrequired
gstinstringoptional
Supplier GSTIN
Example: "27AHQPA7588L1ZJ"
ret_periodstringoptional
Return Period
Example: "022024"
chksumstringoptional
Checksum Value
Example: "e019706b5c029430c81cc4f620c72adf0fc43ceb1805099abe0f1a41a79cfbc5"
section_summaryarray<object>optional
Array items:
chksumstringoptional
Invoice Check Sum Value
Example: "e019706b5c029430c81cc4f620c72adf0fc43ceb1805099abe0f1a41a79cfbc5"
cpty_sumarray<object>optional
Array items:
chksumstringoptional
Invoice Check Sum value
Example: "e019706b5c029430c81cc4f620c72adf0fc43ceb1805099abe0f1a41a79cfbc5"
ctinstringoptional
Receiver TIN for B2B & CDN
Example: "27AHQPA7588L1ZJ"
rcnumberoptional
Record Count
Example: 10
ttl_txpd_cessnumberoptional
Total Tax Paid CESS
Example: 10
ttl_txpd_cgstnumberoptional
Total Tax Paid CGST
Example: 124.99
ttl_txpd_igstnumberoptional
Total Tax Paid IGST
Example: 124.99
ttl_txpd_sgstnumberoptional
Total Tax Paid SGST
Example: 124.99
ttl_valnumberoptional
Total Invoice Value
Example: 12345
ttl_taxnumberoptional
Total Taxable Value
Example: 123
rcnumberoptional
Record Count
Example: 10
sec_nmstringoptional
Return Section
Example: "B2B"
ttl_txpd_cessnumberoptional
Total Tax Paid CESS
Example: 10
ttl_txpd_cgstnumberoptional
Total Tax Paid CGST
Example: 10
ttl_txpd_igstnumberoptional
Total Tax Paid IGST
Example: 10
ttl_txpd_sgstnumberoptional
Total Tax Paid SGST
Example: 10
ttl_valnumberoptional
Total Invoice Value
Example: 10
ttl_taxnumberoptional
Total Taxable Value
Example: 10
txiobjectoptional
diffItcarray<object>optional
Array items:
cessnumberoptional
CESS Amount
Example: 10
cgstnumberoptional
CGST Amount
Example: 10
igstnumberoptional
IGST Amount
Example: 10
rtnumberoptional
Tax Rate
Example: 10
sgstnumberoptional
SGST Amount
Example: 10
txvalnumberoptional
Taxable Value as per Invoice
Example: 10
liabarray<object>optional
Array items:
cessnumberoptional
CESS Amount
Example: 10
cgstnumberoptional
CGST Amount
Example: 10
igstnumberoptional
IGST Amount
Example: 10
rtnumberoptional
Tax Rate
Example: 10
sgstnumberoptional
SGST Amount
Example: 10
txvalnumberoptional
Taxable Value as per Invoice
Example: 10
offsetobjectoptional
pdcasharray<object>optional
Array items:
trans_typnumberoptional
Transaction code
Example: 30002
ipdnumberoptional
Igst Tax paid through cash
Example: 3517817
cpdnumberoptional
Cgst Tax paid through cash
Example: 3517817
spdnumberoptional
Sgst Tax paid through cash
Example: 3517817
cspdnumberoptional
Cgst Tax paid through cash
Example: 3517817
c_intrpdnumberoptional
Cgst Interest paid through cash
Example: 30
c_lfeepdnumberoptional
Cgst Late Fee paid through cash
Example: 13
cs_intrpdnumberoptional
Cess Interest paid through cash
Example: 15
i_intrpdnumberoptional
Igst Interest paid through cash
Example: 20
s_intrpdnumberoptional
Sgst Interest paid through cash
Example: 10
s_lfeepdnumberoptional
Sgst Late fee paid through cash
Example: 13
pditcobjectoptional
trans_typnumberoptional
Transaction code
Example: 30002
i_pdinumberoptional
Igst Tax paid through Igst ITC
Example: 3517817
i_pdcnumberoptional
Igst Tax paid through Cgst ITC
Example: 2290459
i_pdsnumberoptional
Igst Tax paid through Sgst ITC
Example: 2290459
c_pdcnumberoptional
Cgst Tax paid through Cgst ITC
Example: 2290459
c_pdinumberoptional
Cgst Tax paid through Igst ITC
Example: 3517817
s_pdinumberoptional
Sgst Tax paid through Igst ITC
Example: 3517817
s_pdsnumberoptional
Sgst Tax paid through Sgst ITC
Example: 2290459
cs_pdcsnumberoptional
Cess Tax paid through Cess ITC
Example: 2290459
txpdobjectoptional
tax_paidcasharray<object>optional
Array items:
cessobjectoptional
cgstobjectoptional
liab_idintegeroptional
Liability Id
Example: 7865
trancdintegeroptional
Trans Code
Example: 30002
trandatestringoptional
Trans Date
Example: "11-02-2024"
igstobjectoptional
sgstobjectoptional
tax_paiditcarray<object>optional
Array items:
debit_idstringoptional
Debit Id
Example: "DC0504170000000"
liab_idintegeroptional
Liability Id
Example: 7687
trancdintegeroptional
Trans Code
Example: 30002
trandatestringoptional
Trans Date
Example: "11-02-2024"
igst_igst_amtnumberoptional
IGST as IGST
Example: 0
igst_cgst_amtnumberoptional
IGST as CGST
Example: 0
igst_sgst_amtnumberoptional
IGST as SGST
Example: 0
sgst_sgst_amtnumberoptional
SGST as SGST
Example: 0
sgst_igst_amtnumberoptional
SGST as IGST
Example: 0
cgst_cgst_amtnumberoptional
CGST as CGST
Example: 0
cgst_igst_amtnumberoptional
CGST as IGST
Example: 0
cess_cess_amtnumberoptional
CESS as CESS
Example: 0
tax_payarray<object>optional
Array items:
cessobjectoptional
liab_idintegeroptional
Liability Id
Example: 10
trancdintegeroptional
Trans Code
Example: 10
trandatestringoptional
Trans Date
Example: "24-10-2017"
cgstobjectoptional
igstobjectoptional
sgstobjectoptional

Response

Not Found. If requested entity is not found or if requested API is not found.
POST/gstr5/retfile
1const response = await fetch('https://apisandbox.whitebooks.in/gstr5/retfile?email=value', {
2 method: 'POST',
3 headers: {
4 gstin: "value",
5 ret_period: "value",
6 gst_username: "value",
7 state_cd: "value",
8 ip_address: "value",
9 txn: "value",
10 client_id: "value",
11 client_secret: "value",
12 Content-Type: "application/json"
13},
14 body: JSON.stringify({
15 "gstin": "27AHQPA7588L1ZJ",
16 "ret_period": "022024",
17 "chksum": "e019706b5c029430c81cc4f620c72adf0fc43ceb1805099abe0f1a41a79cfbc5",
18 "section_summary": [
19 {
20 "chksum": "e019706b5c029430c81cc4f620c72adf0fc43ceb1805099abe0f1a41a79cfbc5",
21 "cpty_sum": [
22 {
23 "chksum": "e019706b5c029430c81cc4f620c72adf0fc43ceb1805099abe0f1a41a79cfbc5",
24 "ctin": "27AHQPA7588L1ZJ",
25 "rc": 10,
26 "ttl_txpd_cess": 10,
27 "ttl_txpd_cgst": 124.99,
28 "ttl_txpd_igst": 124.99,
29 "ttl_txpd_sgst": 124.99,
30 "ttl_val": 12345,
31 "ttl_tax": 123
32 }
33 ],
34 "rc": 10,
35 "sec_nm": "B2B",
36 "ttl_txpd_cess": 10,
37 "ttl_txpd_cgst": 10,
38 "ttl_txpd_igst": 10,
39 "ttl_txpd_sgst": 10,
40 "ttl_val": 10,
41 "ttl_tax": 10
42 }
43 ],
44 "txi": {
45 "diffItc": [
46 {
47 "cess": 10,
48 "cgst": 10,
49 "igst": 10,
50 "rt": 10,
51 "sgst": 10,
52 "txval": 10
53 }
54 ],
55 "liab": [
56 {
57 "cess": 10,
58 "cgst": 10,
59 "igst": 10,
60 "rt": 10,
61 "sgst": 10,
62 "txval": 10
63 }
64 ]
65 },
66 "offset": {
67 "pdcash": [
68 {
69 "trans_typ": 30002,
70 "ipd": 3517817,
71 "cpd": 3517817,
72 "spd": 3517817,
73 "cspd": 3517817,
74 "c_intrpd": 30,
75 "c_lfeepd": 13,
76 "cs_intrpd": 15,
77 "i_intrpd": 20,
78 "s_intrpd": 10,
79 "s_lfeepd": 13
80 }
81 ],
82 "pditc": {
83 "trans_typ": 30002,
84 "i_pdi": 3517817,
85 "i_pdc": 2290459,
86 "i_pds": 2290459,
87 "c_pdc": 2290459,
88 "c_pdi": 3517817,
89 "s_pdi": 3517817,
90 "s_pds": 2290459,
91 "cs_pdcs": 2290459
92 }
93 },
94 "txpd": {
95 "tax_paidcash": [
96 {
97 "cess": {
98 "intr": 4,
99 "oth": 0,
100 "tx": 1,
101 "fee": 5000,
102 "tot": 5005,
103 "pen": 0
104 },
105 "cgst": {
106 "intr": 4,
107 "oth": 0,
108 "tx": 1,
109 "fee": 5000,
110 "tot": 5005,
111 "pen": 0
112 },
113 "liab_id": 7865,
114 "trancd": 30002,
115 "trandate": "11-02-2024",
116 "igst": {
117 "intr": 4,
118 "oth": 0,
119 "tx": 1,
120 "fee": 5000,
121 "tot": 5005,
122 "pen": 0
123 },
124 "sgst": {
125 "intr": 4,
126 "oth": 0,
127 "tx": 1,
128 "fee": 5000,
129 "tot": 5005,
130 "pen": 0
131 }
132 }
133 ],
134 "tax_paiditc": [
135 {
136 "debit_id": "DC0504170000000",
137 "liab_id": 7687,
138 "trancd": 30002,
139 "trandate": "11-02-2024",
140 "igst_igst_amt": 0,
141 "igst_cgst_amt": 0,
142 "igst_sgst_amt": 0,
143 "sgst_sgst_amt": 0,
144 "sgst_igst_amt": 0,
145 "cgst_cgst_amt": 0,
146 "cgst_igst_amt": 0,
147 "cess_cess_amt": 0
148 }
149 ],
150 "tax_pay": [
151 {
152 "cess": {
153 "intr": 4,
154 "oth": 0,
155 "tx": 1,
156 "fee": 5000,
157 "tot": 5005,
158 "pen": 0
159 },
160 "liab_id": 10,
161 "trancd": 10,
162 "trandate": "24-10-2017",
163 "cgst": {
164 "intr": 4,
165 "oth": 0,
166 "tx": 1,
167 "fee": 5000,
168 "tot": 5005,
169 "pen": 0
170 },
171 "igst": {
172 "intr": 4,
173 "oth": 0,
174 "tx": 1,
175 "fee": 5000,
176 "tot": 5005,
177 "pen": 0
178 },
179 "sgst": {
180 "intr": 4,
181 "oth": 0,
182 "tx": 1,
183 "fee": 5000,
184 "tot": 5005,
185 "pen": 0
186 }
187 }
188 ]
189 }
190}),
191});
192
193const data = await response.json();
194console.log(data);
No example available.