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

# GSTR-1A ECOMA

> This API is to get ECOMA Details

#### 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-1a/documents/ecoma.json" arrow="true" horizontal />


## OpenAPI

````yaml api-reference/gst/compliance/openapi.json GET /gst/compliance/tax-payer/gstrs/gstr-1a/ecoma/{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-1a/ecoma/{year}/{month}:
    get:
      tags:
        - Taxpayer
        - Returns
        - GSTR-1A Documents
      summary: GSTR-1A ECOMA
      description: This API is to get ECOMA Details
      operationId: getGstr1aEcoma
      parameters:
        - name: year
          in: path
          description: Return year, for example `2025`.
          required: true
          example: '2026'
          schema:
            type: string
        - name: month
          in: path
          description: Return month, for example `04`.
          required: true
          example: '04'
          schema:
            type: string
        - name: recipient_gstin
          in: query
          description: Optional recipient GSTIN filter.
          required: false
          example: 20GRRHF2562D3A3
          schema:
            type: string
        - name: sub_section
          in: query
          description: Optional subsection filter.
          required: false
          example: ECOM_B2B
          schema:
            type: string
        - name: authorization
          in: header
          description: >-
            GST taxpayer access token. For token-generation steps, refer to the
            Generate Taxpayer Session flow and pass the token in the
            authorization header.
          required: true
          example: '{{gsp_access_token}}'
          schema:
            type: string
        - name: x-api-version
          in: header
          description: Compliance API version.
          required: false
          example: 1.0.0
          schema:
            type: string
            default: 1.0.0
        - name: x-api-key
          in: header
          description: API key for identification.
          required: true
          example: '{{api_key}}'
          schema:
            type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties: {}
              examples:
                success:
                  summary: Success
                  value:
                    code: 200
                    timestamp: 1763446641000
                    transaction_id: 41bb8041-fb83-4654-8d75-85a19f329158
                    data:
                      status_cd: '1'
                      data:
                        ecoma:
                          b2ba:
                            - inv:
                                - val: 445677
                                  itms:
                                    - num: 100
                                      itm_det:
                                        rt: 1
                                        txval: 8456
                                        iamt: 84.56
                                  oinum: DE-1
                                  flag: 'N'
                                  inum: de-amd-1
                                  inv_typ: DE
                                  pos: '32'
                                  idt: 08-03-2023
                                  oidt: 12-03-2023
                                  sply_ty: INTER
                                  chksum: >-
                                    6927009f6608b520bb94b0b6890512a91dcc74e5a8723c91280241287058bf66
                              rtin: 32KLJIP1179C1ZF
                              stin: 33CBCHE8993D1Z5
                            - inv:
                                - val: 7654654
                                  itms:
                                    - num: 300
                                      itm_det:
                                        rt: 3
                                        txval: 4567
                                        iamt: 137.01
                                  oinum: test
                                  flag: 'N'
                                  inum: Test-Amend
                                  inv_typ: SEWP
                                  pos: '07'
                                  idt: 02-03-2023
                                  oidt: 21-03-2023
                                  sply_ty: INTER
                                  chksum: >-
                                    6927009f6608b520bb94b0b6890512a91dcc74e5a8723c91280241287058bf66
                                - val: 13567
                                  itms:
                                    - num: 100
                                      itm_det:
                                        rt: 1
                                        txval: 14300
                                        iamt: 0
                                        camt: 137.01
                                        samt: 137.01
                                        csamt: 137.01
                                  oinum: test-2
                                  flag: 'N'
                                  inum: sezwp-amd
                                  inv_typ: SEWOP
                                  pos: '37'
                                  idt: 19-03-2023
                                  oidt: 21-03-2023
                                  sply_ty: INTER
                                  chksum: >-
                                    6927009f6608b520bb94b0b6890512a91dcc74e5a8723c91280241287058bf66
                              rtin: 32KLJIP1179C1ZF
                              stin: 33CBCHE8993D1Z5
                            - inv:
                                - val: 345678
                                  itms:
                                    - num: 100
                                      itm_det:
                                        rt: 1
                                        txval: 65467
                                        iamt: 654.67
                                  oinum: test-1
                                  flag: 'N'
                                  inum: test-amd-1
                                  inv_typ: R
                                  pos: '37'
                                  idt: 14-03-2023
                                  oidt: 15-03-2023
                                  sply_ty: INTER
                                  chksum: >-
                                    6927009f6608b520bb94b0b6890512a91dcc74e5a8723c91280241287058bf66
                              rtin: 32KLJIP1179C1ZF
                              stin: 33CBCHE8993D1Z5
                          b2ca:
                            - pos: '07'
                              posItms:
                                - flag: 'N'
                                  omon: '062022'
                                  sply_ty: INTER
                                  stin: 33CBCHE8993D1Z5
                                  chksum: >-
                                    6927009f6608b520bb94b0b6890512a91dcc74e5a8723c91280241287058bf66
                                  itms:
                                    - csamt: 0
                                      samt: 0
                                      rt: 1.5
                                      txval: 34353
                                      camt: 0
                                      iamt: 515.29
                                    - csamt: 0
                                      samt: 0
                                      rt: 2
                                      txval: 34353
                                      camt: 0
                                      iamt: 515.29
                          urp2ba:
                            - inv:
                                - val: 98765434
                                  itms:
                                    - num: 150
                                      itm_det:
                                        rt: 1.5
                                        txval: 7865
                                        iamt: 117.98
                                  oinum: b2cl/test/1
                                  flag: 'N'
                                  idt: 10-06-2022
                                  inum: b2cl/test/amd/1
                                  oidt: 17-06-2022
                                  pos: '24'
                                  sply_ty: INTER
                                  inv_typ: R
                                  chksum: >-
                                    6927009f6608b520bb94b0b6890512a91dcc74e5a8723c91280241287058bf66
                              rtin: 32KLJIP1179C1ZF
                          urp2ca:
                            - itms:
                                - csamt: 0
                                  samt: 0
                                  rt: 1.5
                                  txval: 34353
                                  camt: 0
                                  iamt: 515.29
                              flag: 'N'
                              pos: '07'
                              omon: '062022'
                              sply_ty: INTER
                              chksum: >-
                                6927009f6608b520bb94b0b6890512a91dcc74e5a8723c91280241287058bf66
                record_not_found:
                  summary: Record Not Found
                  value:
                    code: 200
                    timestamp: 1782370522567
                    data:
                      status_cd: '0'
                      error:
                        message: >-
                          No document found in selected financial year. Either
                          this document exists in a different financial year or
                          the document number is incorrect.
                        error_cd: RET11416
                    transaction_id: cca2b98e-0ec9-4f06-8050-df7d5085eac2
          headers: {}
      deprecated: false
      security: []

````