GST APIEnvironment:
Default OTP575757
API Reference
Overview
Public
Authentication
GSTR
GSTR1
GSTR1A
GSTR2A
GSTR2B
GSTR2X
GSTR3B
GSTR4
GSTR4A
GSTR4Annual
GSTR5
GSTR6
GSTR6A
GSTR7
File GSTR7POST
File GSTR7 dataPOST
Save GSTR7PUT
Get GSTR7 SummaryGET
Get TDS detailsGET
Get TDS ChecksumGET
GSTR8
GSTR9
GSTR9A
GSTR9C
SPIKE
ALL
IMS
ITC03
ITC04
CMP
Payment
Ledger
e-Invoice
Notices
GST APIGSTR7File GSTR7

File GSTR7

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

This API is to File GSTR7

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
GSTIN of Deductor
Example: "12AUGGC1893F3DQ"
fpstringoptional
Return Period
Example: "112017"
tdsobjectoptional
ttl_igstnumberoptional
Total IGST
Example: 1518.06
ttl_cgstnumberoptional
Total CGST
Example: 0
ttl_sgstnumberoptional
Total SGST
Example: 0
ttl_amtDednumberoptional
Total amount paid to deductee on which tax is deducted
Example: 75903
no_recintegeroptional
Total number of deductees
Example: 2
tdsaobjectoptional
ttl_igstnumberoptional
Total IGST amount
Example: 0
ttl_cgstnumberoptional
Total CGST amount
Example: 0
ttl_sgstnumberoptional
Total SGST amount
Example: 0
ttl_amtDednumberoptional
Total amount paid to the deductee on which tax is deducted
Example: 0
no_recintegeroptional
Total no of deductees amended
Example: 0
tax_payarray<object>optional
Array items:
igstobjectoptional
intrnumberoptional
Interest Amount
Example: 0
othnumberoptional
other Amount
Example: 0
txnumberoptional
Tax Amount
Example: 1518
feenumberoptional
Fee Amount
Example: 0
totnumberoptional
Total Amount
Example: 1518
pennumberoptional
Penalty Amount
Example: 0
sgstobjectoptional
intrnumberoptional
Interest Amount
Example: 0
othnumberoptional
other Amount
Example: 0
txnumberoptional
Tax Amount
Example: 0
feenumberoptional
Fee Amount
Example: 0
totnumberoptional
Total Amount
Example: 0
pennumberoptional
Penalty Amount
Example: 0
cgstobjectoptional
intrnumberoptional
Interest Amount
Example: 0
othnumberoptional
other Amount
Example: 0
txnumberoptional
Tax Amount
Example: 0
feenumberoptional
Fee Amount
Example: 0
totnumberoptional
Total Amount
Example: 0
pennumberoptional
Penalty Amount
Example: 0
cessobjectoptional
Cess amount payable
intrnumberoptional
Interest Amount
Example: 0
othnumberoptional
other Amount
Example: 0
txnumberoptional
Tax Amount
Example: 0
feenumberoptional
Fee Amount
Example: 0
totnumberoptional
Total Amount
Example: 0
pennumberoptional
Penalty Amount
Example: 0
liab_idnumberoptional
Liability identifier in ledger
Example: 8855
trancdnumberoptional
Transaction code
Example: 30002
trandatestringoptional
Transaction date
Example: "12-02-2018"
offsetarray<object>optional
Array items:
tran_cdintegeroptional
Transaction code
Example: 30002
sgstobjectoptional
SGST amount
intrnumberoptional
Interest Amount
Example: 0
txnumberoptional
Tax Amount
Example: 3000
feenumberoptional
Fee Amount
Example: 5000
totnumberoptional
Total Amount
Example: 5005
cgstobjectoptional
CGST amount
intrnumberoptional
Interest Amount
Example: 0
txnumberoptional
Tax Amount
Example: 3000
feenumberoptional
Fee Amount
Example: 5000
totnumberoptional
Total Amount
Example: 5005
igstobjectoptional
intrnumberoptional
Interest Amount
Example: 4
txnumberoptional
Tax Amount
Example: 1
totnumberoptional
Total Amount
Example: 5005

Response

Not Found. If requested entity is not found or if requested API is not found.
POST/gstr7/retfile
1const response = await fetch('https://apisandbox.whitebooks.in/gstr7/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": "12AUGGC1893F3DQ",
16 "fp": "112017",
17 "tds": {
18 "ttl_igst": 1518.06,
19 "ttl_cgst": 0,
20 "ttl_sgst": 0,
21 "ttl_amtDed": 75903,
22 "no_rec": 2
23 },
24 "tdsa": {
25 "ttl_igst": 0,
26 "ttl_cgst": 0,
27 "ttl_sgst": 0,
28 "ttl_amtDed": 0,
29 "no_rec": 0
30 },
31 "tax_pay": [
32 {
33 "igst": {
34 "intr": 0,
35 "oth": 0,
36 "tx": 1518,
37 "fee": 0,
38 "tot": 1518,
39 "pen": 0
40 },
41 "sgst": {
42 "intr": 0,
43 "oth": 0,
44 "tx": 0,
45 "fee": 0,
46 "tot": 0,
47 "pen": 0
48 },
49 "cgst": {
50 "intr": 0,
51 "oth": 0,
52 "tx": 0,
53 "fee": 0,
54 "tot": 0,
55 "pen": 0
56 },
57 "cess": {
58 "intr": 0,
59 "oth": 0,
60 "tx": 0,
61 "fee": 0,
62 "tot": 0,
63 "pen": 0
64 },
65 "liab_id": 8855,
66 "trancd": 30002,
67 "trandate": "12-02-2018"
68 }
69 ],
70 "offset": [
71 {
72 "tran_cd": 30002,
73 "sgst": {
74 "intr": 0,
75 "tx": 3000,
76 "fee": 5000,
77 "tot": 5005
78 },
79 "cgst": {
80 "intr": 0,
81 "tx": 3000,
82 "fee": 5000,
83 "tot": 5005
84 },
85 "igst": {
86 "intr": 4,
87 "tx": 1,
88 "tot": 5005
89 }
90 }
91 ]
92}),
93});
94
95const data = await response.json();
96console.log(data);
No example available.