Skip to main content
POST
/
gst
/
compliance
/
tax-payer
/
gstrs
/
gstr-1
/
{year}
/
{month}
curl --request POST \
  --url https://api.sandbox.co.in/gst/compliance/tax-payer/gstrs/gstr-1/{year}/{month} \
  --header 'Content-Type: application/json' \
  --header 'authorization: <authorization>' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "fp": "112023",
  "gstin": "29AAACQ3770E000",
  "gt": 3782969.01,
  "cur_gt": 3782969.01,
  "b2b": [
    {
      "ctin": "01AABCE2207R1Z5",
      "inv": [
        {
          "inum": "S008400",
          "idt": "24-12-2023",
          "val": 729248.16,
          "pos": "06",
          "rchrg": "N",
          "etin": "01AABCE5507R1C4",
          "inv_typ": "R",
          "diff_percent": 0.65,
          "itms": [
            {
              "num": 1,
              "itm_det": {
                "rt": 5,
                "txval": 10000,
                "iamt": 325,
                "csamt": 500
              }
            }
          ]
        }
      ]
    }
  ],
  "b2ba": [
    {
      "ctin": "01AABCE2207R1Z5",
      "inv": [
        {
          "oinum": "S008400",
          "oidt": "24-12-2023",
          "inum": "S008400",
          "idt": "24-12-2023",
          "val": 729248.16,
          "pos": "06",
          "rchrg": "N",
          "etin": "01AABCE5507R1C4",
          "inv_typ": "R",
          "diff_percent": 0.65,
          "itms": [
            {
              "num": 1,
              "itm_det": {
                "rt": 5,
                "txval": 10000,
                "iamt": 325,
                "camt": 0,
                "samt": 0,
                "csamt": 500
              }
            }
          ]
        }
      ]
    }
  ],
  "b2cl": [
    {
      "pos": "05",
      "inv": [
        {
          "inum": "92661",
          "idt": "10-12-2023",
          "val": 784586.33,
          "etin": "27AHQPA8875L1CU",
          "diff_percent": 0.65,
          "itms": [
            {
              "num": 1,
              "itm_det": {
                "rt": 5,
                "txval": 10000,
                "iamt": 325,
                "csamt": 500
              }
            }
          ]
        }
      ]
    }
  ],
  "b2cla": [
    {
      "pos": "06",
      "inv": [
        {
          "oinum": "9266",
          "oidt": "10-02-2023",
          "diff_percent": 0.65,
          "inum": "92661",
          "idt": "10-12-2023",
          "val": 784586.33,
          "etin": "01AABCE5507R1C4",
          "itms": [
            {
              "num": 1,
              "itm_det": {
                "rt": 5,
                "txval": 10000,
                "iamt": 833.33
              }
            }
          ]
        }
      ]
    }
  ],
  "cdnr": [
    {
      "ctin": "01AAAAP1208Q1ZS",
      "nt": [
        {
          "ntty": "C",
          "nt_num": "533515",
          "nt_dt": "23-12-2023",
          "pos": "03",
          "rchrg": "Y",
          "inv_typ": "DE",
          "val": 123123,
          "diff_percent": 0.65,
          "itms": [
            {
              "num": 1,
              "itm_det": {
                "rt": 10,
                "txval": 5225.28,
                "iamt": 339.64,
                "csamt": 789.52
              }
            }
          ]
        }
      ]
    }
  ],
  "cdnra": [
    {
      "ctin": "01AAAAP1208Q1ZS",
      "nt": [
        {
          "ntty": "C",
          "ont_num": "533515",
          "ont_dt": "23-09-2023",
          "nt_num": "533515",
          "nt_dt": "23-12-2023",
          "diff_percent": 0.65,
          "inv_typ": "DE",
          "pos": "03",
          "rchrg": "Y",
          "val": 123123,
          "itms": [
            {
              "num": 1,
              "itm_det": {
                "rt": 10,
                "txval": 5225.28,
                "iamt": 845.22,
                "camt": 0,
                "samt": 0,
                "csamt": 789.52
              }
            }
          ]
        }
      ]
    }
  ],
  "b2cs": [
    {
      "sply_ty": "INTER",
      "diff_percent": 0.65,
      "rt": 5,
      "typ": "E",
      "etin": "01AABCE5507R1C4",
      "pos": "05",
      "txval": 110,
      "iamt": 10,
      "csamt": 10
    },
    {
      "rt": 5,
      "sply_ty": "INTER",
      "diff_percent": 0.65,
      "typ": "OE",
      "txval": 100,
      "iamt": 10,
      "csamt": 10,
      "pos": "05"
    }
  ],
  "b2csa": [
    {
      "omon": "122023",
      "sply_ty": "INTER",
      "diff_percent": 0.65,
      "typ": "E",
      "etin": "01AABCE5507R1C4",
      "pos": "05",
      "itms": [
        {
          "rt": 5,
          "txval": 110,
          "iamt": 10,
          "camt": 0,
          "samt": 0,
          "csamt": 10
        },
        {
          "rt": 12,
          "txval": 110,
          "iamt": 10,
          "camt": 0,
          "samt": 0,
          "csamt": 10
        }
      ]
    }
  ],
  "exp": [
    {
      "exp_typ": "WPAY",
      "inv": [
        {
          "inum": "81542",
          "idt": "12-02-2023",
          "val": 995048.36,
          "sbpcode": "ASB991",
          "sbnum": "7896542",
          "sbdt": "04-10-2023",
          "itms": [
            {
              "txval": 10000,
              "rt": 5,
              "iamt": 833.33,
              "csamt": 100
            }
          ]
        }
      ]
    },
    {
      "exp_typ": "WOPAY",
      "inv": [
        {
          "inum": "81542",
          "idt": "12-02-2023",
          "val": 995048.36,
          "sbpcode": "ASB981",
          "sbnum": "7896542",
          "sbdt": "04-10-2023",
          "itms": [
            {
              "txval": 10000,
              "rt": 0,
              "iamt": 0,
              "csamt": 100
            }
          ]
        }
      ]
    }
  ],
  "expa": [
    {
      "exp_typ": "WPAY",
      "inv": [
        {
          "oinum": "81542",
          "oidt": "12-02-2023",
          "inum": "81542",
          "idt": "12-12-2023",
          "val": 995048.36,
          "sbpcode": "ASB995",
          "sbnum": "1234567",
          "sbdt": "04-10-2023",
          "itms": [
            {
              "txval": 10000,
              "rt": 5,
              "iamt": 833.33,
              "csamt": 100
            }
          ]
        }
      ]
    }
  ],
  "hsn": {
    "data": [
      {
        "num": 1,
        "hsn_sc": "1010",
        "desc": "Goods Description",
        "uqc": "kg",
        "qty": 2.05,
        "txval": 10.23,
        "iamt": 14.52,
        "csamt": 500,
        "rt": 0.1
      }
    ]
  },
  "nil": {
    "inv": [
      {
        "sply_ty": "INTRB2B",
        "expt_amt": 123.45,
        "nil_amt": 1470.85,
        "ngsup_amt": 1258.5
      },
      {
        "sply_ty": "INTRB2C",
        "expt_amt": 123.45,
        "nil_amt": 1470.85,
        "ngsup_amt": 1258.5
      }
    ]
  },
  "txpd": [
    {
      "pos": "05",
      "sply_ty": "INTER",
      "diff_percent": 0.65,
      "itms": [
        {
          "rt": 5,
          "ad_amt": 100,
          "iamt": 9400,
          "csamt": 500
        }
      ]
    }
  ],
  "txpda": [
    {
      "omon": "122023",
      "pos": "05",
      "sply_ty": "INTER",
      "diff_percent": 0.65,
      "itms": [
        {
          "rt": 5,
          "ad_amt": 100,
          "iamt": 9400,
          "csamt": 500
        }
      ]
    }
  ],
  "at": [
    {
      "pos": "05",
      "sply_ty": "INTER",
      "diff_percent": 0.65,
      "itms": [
        {
          "rt": 5,
          "ad_amt": 100,
          "iamt": 9400,
          "csamt": 500
        }
      ]
    }
  ],
  "ata": [
    {
      "omon": "022017",
      "pos": "05",
      "sply_ty": "INTER",
      "diff_percent": 0.65,
      "itms": [
        {
          "rt": 5,
          "ad_amt": 100,
          "iamt": 9400,
          "csamt": 500
        }
      ]
    }
  ],
  "doc_issue": {
    "doc_det": [
      {
        "doc_num": 1,
        "docs": [
          {
            "num": 1,
            "from": "20",
            "to": "29",
            "totnum": 20,
            "cancel": 3,
            "net_issue": 17
          }
        ]
      }
    ]
  },
  "cdnur": [
    {
      "typ": "B2CL",
      "ntty": "C",
      "nt_num": "533515",
      "nt_dt": "23-12-2023",
      "pos": "03",
      "val": 64646,
      "diff_percent": 0.65,
      "itms": [
        {
          "num": 1,
          "itm_det": {
            "rt": 10,
            "txval": 5225.28,
            "iamt": 339.64,
            "csamt": 789.52
          }
        }
      ]
    }
  ],
  "cdnura": [
    {
      "ont_num": "533515",
      "ont_dt": "23-09-2023",
      "nt_num": "533515",
      "nt_dt": "23-12-2023",
      "ntty": "C",
      "typ": "B2CL",
      "pos": "03",
      "val": 123123,
      "diff_percent": 0.65,
      "itms": [
        {
          "num": 1,
          "itm_det": {
            "rt": 10,
            "txval": 5225.28,
            "iamt": 845.22,
            "csamt": 789.52
          }
        }
      ]
    }
  ]
}
'
{
  "code": 200,
  "data": {
    "data": {
      "reference_id": "dfb8f5a1-04c3-4f95-bb60-e13ce9b7221c"
    },
    "status_cd": "1"
  },
  "timestamp": 1763446641000,
  "transaction_id": "02b23947-f428-4deb-844d-c4e8456bb04d"
}

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-version
string
default:1.0.0

API version

ā€‹
x-api-key
string
required

API key for identification

Path Parameters

ā€‹
year
string
required

Year e.g. 2020

Example:

"{{year}}"

ā€‹
month
string
required

Month e.g. 01

Example:

"{{month}}"

Body

application/json

Sample Payload. Clear to manually input values

Response

200 - application/json

200 Success / AUTH117 GSTR-1 is already filed

ā€‹
code
number
Example:

200

ā€‹
data
object
ā€‹
timestamp
number
Example:

1763446641000

ā€‹
transaction_id
string
Example:

"02b23947-f428-4deb-844d-c4e8456bb04d"