> ## 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. # File GSTR-3B > File GSTR-3B by passing the GSTR-3B Details response after offsetting liabilities for the authenticated taxpayer. #### Request body schema ## OpenAPI ````yaml api-reference/gst/compliance/openapi.json POST /gst/compliance/tax-payer/gstrs/gstr-3b/{year}/{month}/file openapi: 3.0.1 info: title: compliance description: >- **GST Compliance API** enables businesses to automate compliance requirements like [Taxpayer verification](https://developer.sandbox.co.in/reference/search-gstin-api), [GSTR Filing](https://developer.sandbox.co.in/reference/gst-taxpayer-authentication), [Generating E-Invoices](https://developer.sandbox.co.in/reference/e-invoice-authentication-api), and [E-Way Bills](https://developer.sandbox.co.in/reference/e-way-bill-authentication-api).We provide these APIs from GSTN-authorised GST Suvidha Providers, handling the encryption-decryption and signing so you don't have to handle the complexities. version: 1.0.0 servers: - url: https://api.sandbox.co.in - url: https://test-api.sandbox.co.in security: [] tags: - name: Public - name: Taxpayer - name: Taxpayer Auth - name: Returns - name: GSTR-1 Documents - name: File GSTR-1 - name: GSTR-2A Documents - name: GSTR-2B Document - name: File GSTR-3B - name: GSTR-4 - name: File GSTR-9 - name: Invoice Management System - name: GSTR-1A Documents - name: File GSTR-1A - name: Ledgers - name: e-Invoice - name: Sales e-Invoices for return period - name: Purchase e-Invoices for return period - name: Front Office Notices - name: Front Office - name: AATO - name: e-Invoice1 - name: Authentication - name: e-Invoice12 - name: E-Way Bill - name: E-Way Bill1 - name: Authentication1 - name: Consignor - name: Consolidated E-Way Bill - name: Multi-Vehicle Movement - name: Consignee - name: Transporter - name: Consolidated E-Way Bill1 - name: Multi-vehicle Movement - name: Common paths: /gst/compliance/tax-payer/gstrs/gstr-3b/{year}/{month}/file: post: tags: - Taxpayer - Returns - File GSTR-3B summary: File GSTR-3B description: Authenticated tax payer can upload GSTR-3B json to GST portal operationId: fileGstr3b parameters: - name: year in: path description: '' required: true example: '' schema: type: string - name: month in: path description: '' required: true example: '' schema: type: string - name: pan in: query description: PAN of the authorized signatory required: true schema: type: string example: '{{pan}}' - name: otp in: query description: Generated EVC OTP required: true schema: type: string example: '575757' - name: authorization in: header description: >- GST taxpayer access token. For token-generation steps, refer to the [Generate Taxpayer Session](/recipes/gst/authentication/generate_tax_payer_session) recipe, then pass the token in the authorization header. required: true example: '' schema: type: string - name: x-api-key in: header description: API key for identification required: true example: '' schema: type: string - name: x-api-version in: header description: API version required: false example: '' schema: type: string default: 1.0.0 requestBody: content: application/json: schema: type: object properties: {} examples: 200 Success: value: ret_period: '102024' tx_pmt: net_tax_pay: - sgst: intr: 0 tx: 4841 fee: 0 liab_ldg_id: 0 tran_desc: Other than Reverse Charge cgst: intr: 0 tx: 4841 fee: 0 cess: intr: 0 tx: 0 fee: 0 igst: intr: 0 tx: 259471 fee: 0 trans_typ: 30002 - sgst: intr: 0 tx: 9000 fee: 0 liab_ldg_id: 0 tran_desc: Reverse charge and supplies made u/s 9(5) cgst: intr: 0 tx: 9000 fee: 0 cess: intr: 0 tx: 0 fee: 0 igst: intr: 0 tx: 0 fee: 0 trans_typ: 30003 adjnegliab: [] pdnls: [] pdcash: - liab_ldg_id: 757163094 spd: 0 c_intrpd: 0 i_lfeepd: 0 cspd: 0 s_intrpd: 0 trans_typ: 30002 i_intrpd: 0 s_lfeepd: 0 cpd: 0 c_lfeepd: 0 cs_intrpd: 0 cs_lfeepd: 0 ipd: 44357 - liab_ldg_id: 757163095 spd: 9000 c_intrpd: 0 i_lfeepd: 0 cspd: 0 s_intrpd: 0 trans_typ: 30003 i_intrpd: 0 s_lfeepd: 0 cpd: 9000 c_lfeepd: 0 cs_intrpd: 0 cs_lfeepd: 0 ipd: 0 pditc: s_pds: 4841 liab_ldg_id: 757163094 c_pdi: 0 cs_pdcs: 0 s_pdi: 0 i_pdi: 182450 c_pdc: 4841 i_pdc: 16332 i_pds: 16332 trans_typ: 30002 tx_py: - sgst: intr: 0 tx: 0 fee: 0 liab_ldg_id: 757163094 tran_desc: Other than Reverse Charge cgst: intr: 0 tx: 0 fee: 0 cess: intr: 0 tx: 0 fee: 0 igst: intr: 0 tx: 0 fee: 0 trans_typ: 30002 - sgst: intr: 0 tx: 0 fee: 0 liab_ldg_id: 757163095 tran_desc: Reverse charge and supplies made u/s 9(5) cgst: intr: 0 tx: 0 fee: 0 cess: intr: 0 tx: 0 fee: 0 igst: intr: 0 tx: 0 fee: 0 trans_typ: 30003 eco_dtls: eco_reg_sup: samt: 0 csamt: 0 txval: 0 camt: 0 iamt: 0 eco_sup: samt: 0 csamt: 0 txval: 0 camt: 0 iamt: 0 sup_details: osup_zero: samt: 0 csamt: 0 txval: 0 camt: 0 iamt: 0 osup_nil_exmp: samt: 0 csamt: 0 txval: 0 camt: 0 iamt: 0 osup_nongst: samt: 0 csamt: 0 txval: 0 camt: 0 iamt: 0 osup_det: samt: 4841.23 csamt: 0 txval: 1495299.69 camt: 4841.23 iamt: 259471.16 isup_rev: samt: 9000 csamt: 0 txval: 100000 camt: 9000 iamt: 0 intr_ltfee: ltfee_details: samt: 0 csamt: 0 camt: 0 iamt: 0 intr_details: samt: 0 csamt: 0 camt: 0 iamt: 0 inter_sup: unreg_details: - pos: '27' txval: 846.61 iamt: 152.39 - pos: '07' txval: 1693.22 iamt: 304.78 - pos: '29' txval: 149013.05 iamt: 26822.27 comp_details: - pos: '33' txval: 1157.31 iamt: 208.32 uin_details: [] itc_elg: itc_avl: - samt: 0 csamt: 0 ty: IMPG camt: 0 iamt: 0 - samt: 0 csamt: 0 ty: IMPS camt: 0 iamt: 0 - samt: 9000 csamt: 0 ty: ISRC camt: 9000 iamt: 0 - samt: 0 csamt: 0 ty: ISD camt: 0 iamt: 0 - samt: 12173 csamt: 0 ty: OTH camt: 12173 iamt: 182450 itc_net: samt: 21173 csamt: 0 camt: 21173 iamt: 182450 itc_rev: - samt: 0 csamt: 0 ty: RUL camt: 0 iamt: 0 - samt: 0 csamt: 0 ty: OTH camt: 0 iamt: 0 itc_inelg: - samt: 0 csamt: 0 ty: RUL camt: 0 iamt: 0 - samt: 0 csamt: 0 ty: OTH camt: 0 iamt: 0 gstin: 24ABKCS2033B1ZV summary: 200 Success 200 You cannot file Nil return: value: {} summary: 200 You cannot file Nil return Request Example: value: ret_period: '102024' tx_pmt: net_tax_pay: - sgst: intr: 0 tx: 4841 fee: 0 liab_ldg_id: 0 tran_desc: Other than Reverse Charge cgst: intr: 0 tx: 4841 fee: 0 cess: intr: 0 tx: 0 fee: 0 igst: intr: 0 tx: 259471 fee: 0 trans_typ: 30002 - sgst: intr: 0 tx: 9000 fee: 0 liab_ldg_id: 0 tran_desc: Reverse charge and supplies made u/s 9(5) cgst: intr: 0 tx: 9000 fee: 0 cess: intr: 0 tx: 0 fee: 0 igst: intr: 0 tx: 0 fee: 0 trans_typ: 30003 adjnegliab: [] pdnls: [] pdcash: - liab_ldg_id: 757163094 spd: 0 c_intrpd: 0 i_lfeepd: 0 cspd: 0 s_intrpd: 0 trans_typ: 30002 i_intrpd: 0 s_lfeepd: 0 cpd: 0 c_lfeepd: 0 cs_intrpd: 0 cs_lfeepd: 0 ipd: 44357 - liab_ldg_id: 757163095 spd: 9000 c_intrpd: 0 i_lfeepd: 0 cspd: 0 s_intrpd: 0 trans_typ: 30003 i_intrpd: 0 s_lfeepd: 0 cpd: 9000 c_lfeepd: 0 cs_intrpd: 0 cs_lfeepd: 0 ipd: 0 pditc: s_pds: 4841 liab_ldg_id: 757163094 c_pdi: 0 cs_pdcs: 0 s_pdi: 0 i_pdi: 182450 c_pdc: 4841 i_pdc: 16332 i_pds: 16332 trans_typ: 30002 tx_py: - sgst: intr: 0 tx: 0 fee: 0 liab_ldg_id: 757163094 tran_desc: Other than Reverse Charge cgst: intr: 0 tx: 0 fee: 0 cess: intr: 0 tx: 0 fee: 0 igst: intr: 0 tx: 0 fee: 0 trans_typ: 30002 - sgst: intr: 0 tx: 0 fee: 0 liab_ldg_id: 757163095 tran_desc: Reverse charge and supplies made u/s 9(5) cgst: intr: 0 tx: 0 fee: 0 cess: intr: 0 tx: 0 fee: 0 igst: intr: 0 tx: 0 fee: 0 trans_typ: 30003 eco_dtls: eco_reg_sup: samt: 0 csamt: 0 txval: 0 camt: 0 iamt: 0 eco_sup: samt: 0 csamt: 0 txval: 0 camt: 0 iamt: 0 sup_details: osup_zero: samt: 0 csamt: 0 txval: 0 camt: 0 iamt: 0 osup_nil_exmp: samt: 0 csamt: 0 txval: 0 camt: 0 iamt: 0 osup_nongst: samt: 0 csamt: 0 txval: 0 camt: 0 iamt: 0 osup_det: samt: 4841.23 csamt: 0 txval: 1495299.69 camt: 4841.23 iamt: 259471.16 isup_rev: samt: 9000 csamt: 0 txval: 100000 camt: 9000 iamt: 0 intr_ltfee: ltfee_details: samt: 0 csamt: 0 camt: 0 iamt: 0 intr_details: samt: 0 csamt: 0 camt: 0 iamt: 0 inter_sup: unreg_details: - pos: '27' txval: 846.61 iamt: 152.39 - pos: '07' txval: 1693.22 iamt: 304.78 - pos: '29' txval: 149013.05 iamt: 26822.27 comp_details: - pos: '33' txval: 1157.31 iamt: 208.32 uin_details: [] itc_elg: itc_avl: - samt: 0 csamt: 0 ty: IMPG camt: 0 iamt: 0 - samt: 0 csamt: 0 ty: IMPS camt: 0 iamt: 0 - samt: 9000 csamt: 0 ty: ISRC camt: 9000 iamt: 0 - samt: 0 csamt: 0 ty: ISD camt: 0 iamt: 0 - samt: 12173 csamt: 0 ty: OTH camt: 12173 iamt: 182450 itc_net: samt: 21173 csamt: 0 camt: 21173 iamt: 182450 itc_rev: - samt: 0 csamt: 0 ty: RUL camt: 0 iamt: 0 - samt: 0 csamt: 0 ty: OTH camt: 0 iamt: 0 itc_inelg: - samt: 0 csamt: 0 ty: RUL camt: 0 iamt: 0 - samt: 0 csamt: 0 ty: OTH camt: 0 iamt: 0 gstin: 24ABKCS2033B1ZV summary: Request Example responses: '200': description: 200 Success / 200 You cannot file Nil return content: application/json: schema: type: object properties: code: type: number example: 200 data: type: object properties: data: type: object properties: ack_num: type: string example: AB2410242527396 19/11/2024 16:23 error: type: object properties: error_cd: type: string example: RT-3BAS1027 message: type: string example: >- There is a checksum mismatch or You cannot file Nil return as there are already saved values in 3B. If error persists quote error number RT-3BAS1027 when you contact customer care for quick resolution. status_cd: type: string example: '1' timestamp: type: number example: 1763446641000 transaction_id: type: string example: 72da34f0-d6d1-4056-92e1-734fc29f0249 examples: 200 Success: summary: 200 Success value: code: 200 data: data: ack_num: AB2410242527396 19/11/2024 16:23 status_cd: '1' timestamp: 1763446641000 transaction_id: 72da34f0-d6d1-4056-92e1-734fc29f0249 200 You cannot file Nil return: summary: 200 You cannot file Nil return value: code: 200 data: error: error_cd: RT-3BAS1027 message: >- There is a checksum mismatch or You cannot file Nil return as there are already saved values in 3B. If error persists quote error number RT-3BAS1027 when you contact customer care for quick resolution. status_cd: '0' timestamp: 1734603529000 transaction_id: 8df2a844-6c40-4da1-9792-334214734b85 headers: {} deprecated: false security: [] ````