Skip to main content
POST
/
gst
/
compliance
/
tax-payer
/
gstrs
/
gstr-1
/
{year}
/
{month}
/
file
curl --request POST \ --url https://api.sandbox.co.in/gst/compliance/tax-payer/gstrs/gstr-1/{year}/{month}/file \ --header 'Content-Type: application/json' \ --header 'authorization: <authorization>' \ --header 'x-api-key: <x-api-key>' \ --data ' { "ret_period": "122023", "newSumFlag": true, "sec_sum": [ { "ttl_igst": 0, "sec_nm": "AT", "ttl_cgst": 0, "ttl_cess": 0, "ttl_tax": 0, "ttl_val": 0, "chksum": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "ttl_rec": 0, "ttl_sgst": 0 }, { "ttl_igst": 0, "act_cgst": 0, "act_tax": 0, "ttl_val": 0, "act_val": 0, "act_igst": 0, "sec_nm": "ATA", "ttl_cgst": 0, "act_cess": 0, "ttl_cess": 0, "ttl_tax": 0, "chksum": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "ttl_rec": 0, "ttl_sgst": 0, "act_sgst": 0 }, { "ttl_igst": 2222.3, "sec_nm": "B2B", "ttl_cgst": 0, "ttl_cess": 0, "ttl_tax": 12346.1, "ttl_val": 14568.4, "chksum": "f6b1125afa380198fe78e5f741bd4df63b398aec472967e5522b0f161febf1c0", "ttl_rec": 4, "ttl_sgst": 0 }, { "ttl_igst": 0, "act_cgst": 0, "act_tax": 0, "ttl_val": 0, "act_val": 0, "act_igst": 0, "sec_nm": "B2BA", "ttl_cgst": 0, "act_cess": 0, "ttl_cess": 0, "ttl_tax": 0, "chksum": "063a5b1a3bbc23d11761b156c446a285d7703be484a276a0a32e29bda10d4f8a", "ttl_rec": 0, "ttl_sgst": 0, "act_sgst": 0 }, { "ttl_igst": 0, "act_cgst": 0, "act_tax": 0, "ttl_val": 0, "act_val": 0, "act_igst": 0, "sec_nm": "B2BA_4A", "ttl_cgst": 0, "act_cess": 0, "ttl_cess": 0, "ttl_tax": 0, "chksum": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "ttl_rec": 0, "ttl_sgst": 0, "act_sgst": 0 }, { "ttl_igst": 0, "act_cgst": 0, "act_tax": 0, "ttl_val": 0, "act_val": 0, "act_igst": 0, "sec_nm": "B2BA_4B", "ttl_cgst": 0, "act_cess": 0, "ttl_cess": 0, "ttl_tax": 0, "chksum": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "ttl_rec": 0, "ttl_sgst": 0, "act_sgst": 0 }, { "ttl_igst": 0, "act_cgst": 0, "act_tax": 0, "ttl_val": 0, "act_val": 0, "act_igst": 0, "sec_nm": "B2BA_6C", "ttl_cgst": 0, "act_cess": 0, "ttl_cess": 0, "ttl_tax": 0, "chksum": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "ttl_rec": 0, "ttl_sgst": 0, "act_sgst": 0 }, { "ttl_igst": 0, "act_cgst": 0, "act_tax": 0, "ttl_val": 0, "act_val": 0, "act_igst": 0, "sec_nm": "B2BA_SEZWOP", "ttl_cgst": 0, "act_cess": 0, "ttl_cess": 0, "ttl_tax": 0, "chksum": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "ttl_rec": 0, "ttl_sgst": 0, "act_sgst": 0 }, { "ttl_igst": 0, "act_cgst": 0, "act_tax": 0, "ttl_val": 0, "act_val": 0, "act_igst": 0, "sec_nm": "B2BA_SEZWP", "ttl_cgst": 0, "act_cess": 0, "ttl_cess": 0, "ttl_tax": 0, "chksum": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "ttl_rec": 0, "ttl_sgst": 0, "act_sgst": 0 }, { "ttl_igst": 2222.3, "sec_nm": "B2B_4A", "ttl_cgst": 0, "ttl_cess": 0, "ttl_tax": 12346.1, "ttl_val": 14568.4, "chksum": "740822e0837d6181a9174db0189955f9989411432abc5bb9d079e70d21064caa", "ttl_rec": 4, "ttl_sgst": 0 }, { "ttl_igst": 0, "sec_nm": "B2B_4B", "ttl_cgst": 0, "ttl_cess": 0, "ttl_tax": 0, "ttl_val": 0, "chksum": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "ttl_rec": 0, "ttl_sgst": 0 }, { "ttl_igst": 0, "sec_nm": "B2B_6C", "ttl_cgst": 0, "ttl_cess": 0, "ttl_tax": 0, "ttl_val": 0, "chksum": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "ttl_rec": 0, "ttl_sgst": 0 }, { "ttl_igst": 0, "sec_nm": "B2B_SEZWOP", "ttl_cgst": 0, "ttl_cess": 0, "ttl_tax": 0, "ttl_val": 0, "chksum": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "ttl_rec": 0, "ttl_sgst": 0 }, { "ttl_igst": 0, "sec_nm": "B2B_SEZWP", "ttl_cgst": 0, "ttl_cess": 0, "ttl_tax": 0, "ttl_val": 0, "chksum": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "ttl_rec": 0, "ttl_sgst": 0 }, { "ttl_igst": 0, "sec_nm": "B2CL", "ttl_cgst": 0, "ttl_cess": 0, "ttl_tax": 0, "ttl_val": 0, "chksum": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "ttl_rec": 0, "ttl_sgst": 0 }, { "ttl_igst": 0, "act_cgst": 0, "act_tax": 0, "ttl_val": 0, "act_val": 0, "act_igst": 0, "sec_nm": "B2CLA", "ttl_cgst": 0, "act_cess": 0, "ttl_cess": 0, "ttl_tax": 0, "chksum": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "ttl_rec": 0, "ttl_sgst": 0, "act_sgst": 0 }, { "ttl_igst": 235524.11, "sec_nm": "B2CS", "ttl_cgst": 2284.92, "ttl_cess": 0, "ttl_tax": 1333854.58, "ttl_val": 1573948.53, "chksum": "61bfe658d7e4a48f4e3d96c390961095747975e63c9d31a164b5da878d47842a", "ttl_rec": 25, "ttl_sgst": 2284.92 }, { "ttl_igst": 0, "act_cgst": 0, "act_tax": 0, "ttl_val": 0, "act_val": 0, "act_igst": 0, "sec_nm": "B2CSA", "ttl_cgst": 0, "act_cess": 0, "ttl_cess": 0, "ttl_tax": 0, "chksum": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "ttl_rec": 0, "ttl_sgst": 0, "act_sgst": 0 }, { "ttl_igst": 237746, "sec_nm": "HSN", "ttl_cgst": 2285, "ttl_cess": 0, "ttl_tax": 1346201, "ttl_val": 0, "chksum": "e085d73dee2753101a57f3a21ea28a6de1d5a148662b326d9626864fd2a1df40", "ttl_rec": 1, "ttl_sgst": 2285 }, { "ttl_nilsup_amt": 0, "ttl_expt_amt": 0, "sec_nm": "NIL", "chksum": "d3bdc0c5ea608c90b800d6c1d3a64a2437a9843d391ca36c1f463e7c44bf45ce", "ttl_rec": 1, "ttl_ngsup_amt": 0 }, { "ttl_igst": 237746.41, "sec_nm": "TTL_LIAB", "ttl_cgst": 2284.92, "ttl_cess": 0, "ttl_tax": 1346200.68, "ttl_val": 1588516.93, "chksum": "dacc6e65dd4342f36377e25d6408a6c59cdd518e9512bb84b1f4103bfa42a26c", "ttl_rec": 32, "ttl_sgst": 2284.92 }, { "ttl_igst": 0, "sec_nm": "TXPD", "ttl_cgst": 0, "ttl_cess": 0, "ttl_tax": 0, "ttl_val": 0, "chksum": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "ttl_rec": 0, "ttl_sgst": 0 }, { "ttl_igst": 0, "act_cgst": 0, "act_tax": 0, "ttl_val": 0, "act_val": 0, "act_igst": 0, "sec_nm": "TXPDA", "ttl_cgst": 0, "act_cess": 0, "ttl_cess": 0, "ttl_tax": 0, "chksum": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "ttl_rec": 0, "ttl_sgst": 0, "act_sgst": 0 }, { "ttl_doc_issued": 853, "sec_nm": "DOC_ISSUE", "net_doc_issued": 853, "ttl_doc_cancelled": 0, "chksum": "021eb7b414ffe7c5ede410deeb7cc0f23a6b9e2e2f0b784e1ff968d2981b4351", "ttl_rec": 2 }, { "ttl_igst": 0, "sec_nm": "CDNR", "ttl_cgst": 0, "sub_sections": [ { "ttl_igst": 0, "sec_nm": "CDNR_4A", "ttl_cgst": 0, "ttl_cess": 0, "ttl_tax": 0, "ttl_val": 0, "chksum": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "ttl_rec": 0, "ttl_sgst": 0 }, { "ttl_igst": 0, "sec_nm": "CDNR_4B", "ttl_cgst": 0, "ttl_cess": 0, "ttl_tax": 0, "ttl_val": 0, "chksum": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "ttl_rec": 0, "ttl_sgst": 0 }, { "ttl_igst": 0, "sec_nm": "CDNR_6C", "ttl_cgst": 0, "ttl_cess": 0, "ttl_tax": 0, "ttl_val": 0, "chksum": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "ttl_rec": 0, "ttl_sgst": 0 }, { "ttl_igst": 0, "sec_nm": "CDNR_SEZWOP", "ttl_cgst": 0, "ttl_cess": 0, "ttl_tax": 0, "ttl_val": 0, "chksum": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "ttl_rec": 0, "ttl_sgst": 0 }, { "ttl_igst": 0, "sec_nm": "CDNR_SEZWP", "ttl_cgst": 0, "ttl_cess": 0, "ttl_tax": 0, "ttl_val": 0, "chksum": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "ttl_rec": 0, "ttl_sgst": 0 } ], "ttl_cess": 0, "ttl_tax": 0, "ttl_val": 0, "chksum": "063a5b1a3bbc23d11761b156c446a285d7703be484a276a0a32e29bda10d4f8a", "ttl_rec": 0, "ttl_sgst": 0 }, { "ttl_igst": 0, "act_cgst": 0, "act_tax": 0, "ttl_val": 0, "act_val": 0, "act_igst": 0, "sec_nm": "CDNRA", "ttl_cgst": 0, "sub_sections": [ { "ttl_igst": 0, "act_cgst": 0, "act_tax": 0, "ttl_val": 0, "act_val": 0, "act_igst": 0, "sec_nm": "CDNRA_4A", "ttl_cgst": 0, "act_cess": 0, "ttl_cess": 0, "ttl_tax": 0, "chksum": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "ttl_rec": 0, "ttl_sgst": 0, "act_sgst": 0 }, { "ttl_igst": 0, "act_cgst": 0, "act_tax": 0, "ttl_val": 0, "act_val": 0, "act_igst": 0, "sec_nm": "CDNRA_4B", "ttl_cgst": 0, "act_cess": 0, "ttl_cess": 0, "ttl_tax": 0, "chksum": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "ttl_rec": 0, "ttl_sgst": 0, "act_sgst": 0 }, { "ttl_igst": 0, "act_cgst": 0, "act_tax": 0, "ttl_val": 0, "act_val": 0, "act_igst": 0, "sec_nm": "CDNRA_6C", "ttl_cgst": 0, "act_cess": 0, "ttl_cess": 0, "ttl_tax": 0, "chksum": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "ttl_rec": 0, "ttl_sgst": 0, "act_sgst": 0 }, { "ttl_igst": 0, "act_cgst": 0, "act_tax": 0, "ttl_val": 0, "act_val": 0, "act_igst": 0, "sec_nm": "CDNRA_SEZWOP", "ttl_cgst": 0, "act_cess": 0, "ttl_cess": 0, "ttl_tax": 0, "chksum": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "ttl_rec": 0, "ttl_sgst": 0, "act_sgst": 0 }, { "ttl_igst": 0, "act_cgst": 0, "act_tax": 0, "ttl_val": 0, "act_val": 0, "act_igst": 0, "sec_nm": "CDNRA_SEZWP", "ttl_cgst": 0, "act_cess": 0, "ttl_cess": 0, "ttl_tax": 0, "chksum": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "ttl_rec": 0, "ttl_sgst": 0, "act_sgst": 0 } ], "act_cess": 0, "ttl_cess": 0, "ttl_tax": 0, "chksum": "063a5b1a3bbc23d11761b156c446a285d7703be484a276a0a32e29bda10d4f8a", "ttl_rec": 0, "ttl_sgst": 0, "act_sgst": 0 }, { "ttl_igst": 0, "sec_nm": "CDNUR", "ttl_cgst": 0, "sub_sections": [ { "ttl_igst": 0, "ttl_cgst": 0, "typ": "B2CL", "ttl_cess": 0, "ttl_tax": 0, "ttl_val": 0, "chksum": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "ttl_rec": 0, "ttl_sgst": 0 }, { "ttl_igst": 0, "ttl_cgst": 0, "typ": "EXPWOP", "ttl_cess": 0, "ttl_tax": 0, "ttl_val": 0, "chksum": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "ttl_rec": 0, "ttl_sgst": 0 }, { "ttl_igst": 0, "ttl_cgst": 0, "typ": "EXPWP", "ttl_cess": 0, "ttl_tax": 0, "ttl_val": 0, "chksum": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "ttl_rec": 0, "ttl_sgst": 0 } ], "ttl_cess": 0, "ttl_tax": 0, "ttl_val": 0, "chksum": "74313561d1897af3dc03f4fae174960d28968f92b49230523faca462b848db60", "ttl_rec": 0, "ttl_sgst": 0 }, { "ttl_igst": 0, "act_cgst": 0, "act_tax": 0, "ttl_val": 0, "act_val": 0, "act_igst": 0, "sec_nm": "CDNURA", "ttl_cgst": 0, "sub_sections": [ { "ttl_igst": 0, "act_cgst": 0, "act_tax": 0, "typ": "B2CL", "ttl_val": 0, "act_val": 0, "act_igst": 0, "ttl_cgst": 0, "act_cess": 0, "ttl_cess": 0, "ttl_tax": 0, "chksum": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "ttl_rec": 0, "ttl_sgst": 0, "act_sgst": 0 }, { "ttl_igst": 0, "act_cgst": 0, "act_tax": 0, "typ": "EXPWOP", "ttl_val": 0, "act_val": 0, "act_igst": 0, "ttl_cgst": 0, "act_cess": 0, "ttl_cess": 0, "ttl_tax": 0, "chksum": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "ttl_rec": 0, "ttl_sgst": 0, "act_sgst": 0 }, { "ttl_igst": 0, "act_cgst": 0, "act_tax": 0, "typ": "EXPWP", "ttl_val": 0, "act_val": 0, "act_igst": 0, "ttl_cgst": 0, "act_cess": 0, "ttl_cess": 0, "ttl_tax": 0, "chksum": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "ttl_rec": 0, "ttl_sgst": 0, "act_sgst": 0 } ], "act_cess": 0, "ttl_cess": 0, "ttl_tax": 0, "chksum": "74313561d1897af3dc03f4fae174960d28968f92b49230523faca462b848db60", "ttl_rec": 0, "ttl_sgst": 0, "act_sgst": 0 }, { "ttl_igst": 0, "sec_nm": "EXP", "ttl_cgst": 0, "sub_sections": [ { "ttl_igst": 0, "ttl_cgst": 0, "typ": "EXPWOP", "ttl_cess": 0, "ttl_tax": 0, "ttl_val": 0, "chksum": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "ttl_rec": 0, "ttl_sgst": 0 }, { "ttl_igst": 0, "ttl_cgst": 0, "typ": "EXPWP", "ttl_cess": 0, "ttl_tax": 0, "ttl_val": 0, "chksum": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "ttl_rec": 0, "ttl_sgst": 0 } ], "ttl_cess": 0, "ttl_tax": 0, "ttl_val": 0, "chksum": "3b7546ed79e3e5a7907381b093c5a182cbf364c5dd0443dfa956c8cca271cc33", "ttl_rec": 0, "ttl_sgst": 0 }, { "ttl_igst": 0, "act_cgst": 0, "act_tax": 0, "ttl_val": 0, "act_val": 0, "act_igst": 0, "sec_nm": "EXPA", "ttl_cgst": 0, "sub_sections": [ { "ttl_igst": 0, "act_cgst": 0, "act_tax": 0, "typ": "EXPWOP", "ttl_val": 0, "act_val": 0, "act_igst": 0, "ttl_cgst": 0, "act_cess": 0, "ttl_cess": 0, "ttl_tax": 0, "chksum": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "ttl_rec": 0, "ttl_sgst": 0, "act_sgst": 0 }, { "ttl_igst": 0, "act_cgst": 0, "act_tax": 0, "typ": "EXPWP", "ttl_val": 0, "act_val": 0, "act_igst": 0, "ttl_cgst": 0, "act_cess": 0, "ttl_cess": 0, "ttl_tax": 0, "chksum": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "ttl_rec": 0, "ttl_sgst": 0, "act_sgst": 0 } ], "act_cess": 0, "ttl_cess": 0, "ttl_tax": 0, "chksum": "3b7546ed79e3e5a7907381b093c5a182cbf364c5dd0443dfa956c8cca271cc33", "ttl_rec": 0, "ttl_sgst": 0, "act_sgst": 0 } ], "gstin": "29AAACQ3770E000", "chksum": "dacc6e65dd4342f36377e25d6408a6c59cdd518e9512bb84b1f4103bfa42a26c" } '
{ "code": 200, "data": { "data": { "ack_num": "ASDFSDF1241343" }, "status_cd": 1 }, "timestamp": 1763446641000, "transaction_id": "578e66be-ff2b-42c2-8987-3f8a86fdcc46" }

Documentation Index

Fetch the complete documentation index at: https://developer.sandbox.co.in/llms.txt

Use this file to discover all available pages before exploring further.

Request body schema

View request body schema

Headers

authorization
string
required

GST taxpayer access token. For token-generation steps, refer to the Generate Taxpayer Session recipe, then pass the token in the authorization header.

x-api-key
string
required

API key for identification

x-api-version
string
default:1.0.0

API version

Path Parameters

year
string
required
Example:

"{{year}}"

month
string
required
Example:

"{{month}}"

Query Parameters

pan
string
required

PAN of the authorized signatory

Example:

"{{pan}}"

otp
string
required

Generated EVC OTP

Example:

"575757"

Body

application/json

File GSTR-1

Response

200 - application/json

200 Success / RT_FIL_10 Please submit invoices before filing / RT_FIL_02 GSTR-1 is already filed

code
number
Example:

200

data
object
timestamp
number
Example:

1763446641000

transaction_id
string
Example:

"578e66be-ff2b-42c2-8987-3f8a86fdcc46"