File GSTR-1 Return with DSC
POST
https://apisandbox.whitebooks.in/gstr1/retfileUsed to file entire GSTR1 invoices.
1-Click Filing Engine
Explore FeatureAutomated GSTR-1 Filing with DSC & EVC
Review final return totals, auto-trigger Aadhaar/mobile OTP or Digital Signature (DSC) authentication, and receive an instant ARN confirmation.
Parameters
query parameters
emailstringrequiredAPI Developer User Email
panstringrequiredPAN Number
header parameters
gstinstringrequiredGST Number
ret_periodstringrequiredReturn Period (MMYYYY)
gst_usernamestringrequiredGST UserName
state_cdstringrequiredState Code
ip_addressstringrequiredIP Address
txnstringrequiredTransaction
client_idstringrequiredClient ID
client_secretstringrequiredClient Secret
Request Body
application/jsonrequired
gstinstringoptionalGSTIN of the Taxpayer
Example: "05AVHPB7348G1ZP"
ret_periodstringoptionalReturn period
Example: "042024"
chksumstringoptionalInvoice Check sum value
Example: "0b194f5f9cfeb178a4d1440103641b81eb17728b9afd6691a3661aa9c3dd0f8d"
newSumFlagbooleanoptionalIs the summary in new or old format
Example: true
sec_sumarray<object>optionalArray items:
sec_nmstringoptionalReturn Section
Example: "CDNRA"
chksumstringoptionalInvoice Check sum value
Example: "da88731791fdf49c66735228563c4bc798f0af67ba0d1a7089c94762e9f724a6"
ttl_recintegeroptionaltotal number of Records
Example: 8
ttl_valnumberoptionaltotal records value
Example: 122222153821.52
ttl_igstnumberoptionaltotal IGST amount
Example: -0.86
ttl_sgstnumberoptionaltotal SGST amount
Example: 11111111036.02
ttl_cgstnumberoptionaltotal CGST amount
Example: 11111111036.02
ttl_cessnumberoptionaltotal cess amount
Example: 55555510860.78
ttl_taxnumberoptional total taxable value of records
Example: -74530
act_taxnumberoptionalactual taxable value of records
Example: -196528
act_igstnumberoptionalactual IGST amount
Example: -13371.73
act_sgstnumberoptionalactual SGST amount
Example: -37044.2
act_cgstnumberoptionalactual CGST amount
Example: -37044.2
act_valnumberoptionalactual records value
Example: -108419
act_cessnumberoptionalactual cess amount
Example: -71148
sub_sectionsarray<object>optionalArray items:
sec_nmstringoptionalReturn Section
Example: "CDNRA_4A"
chksumstringoptionalInvoice Check sum value
Example: "568b1d868a64fb0f22079968624ccf6b46e93579b092c2390ded564015099ede"
ttl_recintegeroptionaltotal number of Records
Example: 2
ttl_valnumberoptionaltotal records value
Example: -111111
ttl_igstnumberoptionaltotal IGST amount
Example: 5740.73
ttl_sgstnumberoptionaltotal SGST amount
Example: -212.93
ttl_cgstnumberoptionaltotal CGST amount
Example: -212.93
ttl_cessnumberoptionaltotal cess amount
Example: -51111
ttl_taxnumberoptional total taxable value of records
Example: 70865
act_taxnumberoptionalactual taxable value of records
Example: 12340
act_igstnumberoptionalactual IGST amount
Example: 2340
act_sgstnumberoptionalactual SGST amount
Example: 340
act_cgstnumberoptionalactual CGST amount
Example: 234230
act_valnumberoptionalactual records value
Example: 343430
act_cessnumberoptionalactual cess amount
Example: 355550
Response
Not Found. If requested entity is not found or if requested API is not found.
Frequently Asked Questions
Before invoking the file endpoint: (1) all invoices must be saved via
/gstr1/retsave, (2) all uploaded sections must show status PROCESSED via tracking, and (3) summary must be generated and verified. Calling file before summary completion causes rejection.The request requires
pan and email as query parameters, standard authentication headers, and a body containing gstin, ret_period, chksum (checksum of the generated summary), and verification flags.Yes. For DSC (Digital Signature Certificate) signing, provide the PKCS#7 signed hash. For EVC (Electronic Verification Code), use the dedicated EVC filing endpoint (
/gstr1/retevcfile) with the mobile/email OTP.Upon successful filing, GSTN returns an Acknowledgement Reference Number (
arn) along with timestamp, confirming official return receipt.No example available.