> ## 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.

# Get GSTR-2A B2BA

> Get all amended B2B invoices in GSTR-2A for a return period for authenticated taxpayer

#### Response body schema

<Card title="View response body schema" icon="code" href="https://raw.githubusercontent.com/in-co-sandbox/in-co-sandbox-docs/refs/heads/main/data/gst/schema/request/taxpayer/gstr-2a/b2ba.json" arrow="true" horizontal />


## OpenAPI

````yaml api-reference/gst/compliance/openapi.json GET /gst/compliance/tax-payer/gstrs/gstr-2a/b2ba/{year}/{month}
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-2a/b2ba/{year}/{month}:
    get:
      tags:
        - Taxpayer
        - Returns
        - GSTR-2A Documents
      summary: Get GSTR-2A B2BA
      description: >-
        Get all amended B2B invoices in GSTR-2A for a return period for
        authenticated taxpayer
      operationId: getGstr2aB2ba
      parameters:
        - name: year
          in: path
          description: ''
          required: true
          example: ''
          schema:
            type: string
        - name: month
          in: path
          description: ''
          required: true
          example: ''
          schema:
            type: string
        - name: counterparty_gstin
          in: query
          description: '`optional` Counter party GSTIN'
          required: false
          schema:
            type: string
            example: '{{ctin}}'
        - 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
      responses:
        '200':
          description: 200 Success / RET13509 No data found
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: number
                    example: 200
                  data:
                    type: object
                    properties:
                      data:
                        type: object
                        properties:
                          b2ba:
                            type: array
                            items:
                              type: object
                              properties:
                                cfs:
                                  type: string
                                  example: 'Y'
                                cfs3b:
                                  type: string
                                  example: 'Y'
                                ctin:
                                  type: string
                                  example: 24ABCCR0123M1YZ
                                fldtr1:
                                  type: string
                                  example: 10-Jan-24
                                flprdr1:
                                  type: string
                                  example: Dec-23
                                inv:
                                  type: array
                                  items:
                                    type: object
                                    properties:
                                      aspd:
                                        type: string
                                        example: Oct-23
                                      atyp:
                                        type: string
                                        example: D
                                      chksum:
                                        type: string
                                        example: >-
                                          6a93632fb89ac2028409a04ef1b538d38e9e50503b69c1ddd182570d61615aea
                                      idt:
                                        type: string
                                        example: 25-10-2023
                                      inum:
                                        type: string
                                        example: RN1/FAMA-16557
                                      inv_typ:
                                        type: string
                                        example: R
                                      itms:
                                        type: array
                                        items:
                                          type: object
                                          properties:
                                            itm_det:
                                              type: object
                                              properties:
                                                camt:
                                                  type: number
                                                  example: 0
                                                iamt:
                                                  type: number
                                                  example: 0
                                                rt:
                                                  type: number
                                                  example: 18
                                                samt:
                                                  type: number
                                                  example: 0
                                                txval:
                                                  type: number
                                                  example: 0.01
                                            num:
                                              type: number
                                              example: 1418
                                        example:
                                          - itm_det:
                                              camt: 0
                                              iamt: 0
                                              rt: 18
                                              samt: 0
                                              txval: 0.01
                                            num: 1418
                                      oidt:
                                        type: string
                                        example: 25-10-2023
                                      oinum:
                                        type: string
                                        example: RN1/FAMA-16557
                                      pos:
                                        type: string
                                        example: '24'
                                      rchrg:
                                        type: string
                                        example: 'N'
                                      val:
                                        type: number
                                        example: 0.01
                                  example:
                                    - aspd: Oct-23
                                      atyp: D
                                      chksum: >-
                                        6a93632fb89ac2028409a04ef1b538d38e9e50503b69c1ddd182570d61615aea
                                      idt: 25-10-2023
                                      inum: RN1/FAMA-16557
                                      inv_typ: R
                                      itms:
                                        - itm_det:
                                            camt: 0
                                            iamt: 0
                                            rt: 18
                                            samt: 0
                                            txval: 0.01
                                          num: 1418
                                      oidt: 25-10-2023
                                      oinum: RN1/FAMA-16557
                                      pos: '24'
                                      rchrg: 'N'
                                      val: 0.01
                            example:
                              - cfs: 'Y'
                                cfs3b: 'Y'
                                ctin: 24ABCCR0123M1YZ
                                fldtr1: 10-Jan-24
                                flprdr1: Dec-23
                                inv:
                                  - aspd: Oct-23
                                    atyp: D
                                    chksum: >-
                                      6a93632fb89ac2028409a04ef1b538d38e9e50503b69c1ddd182570d61615aea
                                    idt: 25-10-2023
                                    inum: RN1/FAMA-16557
                                    inv_typ: R
                                    itms:
                                      - itm_det:
                                          camt: 0
                                          iamt: 0
                                          rt: 18
                                          samt: 0
                                          txval: 0.01
                                        num: 1418
                                    oidt: 25-10-2023
                                    oinum: RN1/FAMA-16557
                                    pos: '24'
                                    rchrg: 'N'
                                    val: 0.01
                      error:
                        type: object
                        properties:
                          error_cd:
                            type: string
                            example: RET13509
                          message:
                            type: string
                            example: No document found for the provided Inputs
                      status_cd:
                        type: string
                        example: '1'
                  timestamp:
                    type: number
                    example: 1763446641000
                  transaction_id:
                    type: string
                    example: 28ddcef3-cea8-449b-bc59-7aac885e6216
              examples:
                200 Success:
                  summary: 200 Success
                  value:
                    code: 200
                    data:
                      data:
                        b2ba:
                          - cfs: 'Y'
                            cfs3b: 'Y'
                            ctin: 24ABCCR0123M1YZ
                            fldtr1: 10-Jan-24
                            flprdr1: Dec-23
                            inv:
                              - aspd: Oct-23
                                atyp: D
                                chksum: >-
                                  6a93632fb89ac2028409a04ef1b538d38e9e50503b69c1ddd182570d61615aea
                                idt: 25-10-2023
                                inum: RN1/FAMA-16557
                                inv_typ: R
                                itms:
                                  - itm_det:
                                      camt: 0
                                      iamt: 0
                                      rt: 18
                                      samt: 0
                                      txval: 0.01
                                    num: 1418
                                oidt: 25-10-2023
                                oinum: RN1/FAMA-16557
                                pos: '24'
                                rchrg: 'N'
                                val: 0.01
                      status_cd: '1'
                    timestamp: 1763446641000
                    transaction_id: 28ddcef3-cea8-449b-bc59-7aac885e6216
                RET13509 No data found:
                  summary: RET13509 No data found
                  value:
                    code: 200
                    data:
                      error:
                        error_cd: RET13509
                        message: No document found for the provided Inputs
                      status_cd: '0'
                    timestamp: 1763446641000
                    transaction_id: 9f98706e-6745-4963-9bbe-e0c85833bc8b
          headers: {}
      deprecated: false
      security: []

````