Skip to main content

​
GSTR-2A API

GSTR-2A is an auto-drafted inward supplies statement on the GST portal that reflects documents uploaded by suppliers for a return period. Use these APIs to retrieve GSTR-2A documents (B2B invoices, credit/debit notes, ISD, imports, TDS/TCS, amendments) to reconcile purchase data and monitor Input Tax Credit (ITC).

Section-wise inward documents

Retrieve B2B invoices, credit/debit notes, ISD credits, imports (IMPG/IMPGSEZ), and TDS/TCS deductions from suppliers.

Amendment visibility

Track supplier amendments with B2BA, CDNA, ECOMA endpoints and view change history through AMDHIST.

Reconciliation-ready outputs

Normalize inward supply data to match purchase registers and vendor records.

Compliance-safe access

Access GSTR-2A through authenticated taxpayer sessions.

​
How it works

1

Authenticate taxpayer

Call Generate OTP and Verify OTP to start a taxpayer session valid for 6 hours.
2

Create or refresh session

Use the session token for all GSTR-2A calls and refresh it with Refresh Session for long-running pulls.
3

Select return period

Specify the year and month for the GSTR-2A data you want to retrieve.
4

Fetch GSTR-2A data

Retrieve complete GSTR-2A documents or section-wise data via B2B, CDN, and other relevant endpoints.
5

Normalize and store results

Process the retrieved data for reconciliation against purchase records and audit trails.
6

Re-run for amendments

GSTR-2A is a dynamic statement - re-fetch periodically to detect supplier amendments and new uploads.

​
API categories

Core invoices

B2B and B2BA endpoints for supplier invoices and amendments

Credit/Debit notes

CDN and CDNA endpoints for notes from registered suppliers

E-commerce & TCS

ECOM, ECOMA, and TCS endpoints for e-commerce operator data

Imports & SEZ

IMPG and IMPGSEZ endpoints for import-related inward supplies

Other credits

ISD and TDS endpoints for Input Service Distributor and TDS credits

Change tracking

AMDHIST endpoint for amendment history and change audit

​
Core invoice APIs

Retrieve B2B invoices and their amendments:
APITable/CodeDescription
GSTR-2A B2BB2BInvoices from registered suppliers (inward supplies)
GSTR-2A B2BAB2BAAmendments to B2B invoices by suppliers

​
Credit/Debit note APIs

Retrieve credit and debit notes from suppliers:
APITable/CodeDescription
GSTR-2A CDNCDNCredit/Debit notes from registered suppliers
GSTR-2A CDNACDNAAmendments to credit/debit notes

​
E-commerce and TCS APIs

Retrieve e-commerce operator supplies and TCS data:
APITable/CodeDescription
GSTR-2A ECOMECOMSupplies through e-commerce operators
GSTR-2A ECOMAECOMAAmendments to e-commerce supplies
GSTR-2A TCSTCSTax Collected at Source by e-commerce operators

​
Import APIs

Retrieve import and SEZ-related inward supplies:
APITable/CodeDescription
GSTR-2A IMPGIMPGImports of goods (Bill of Entry data)
GSTR-2A IMPGSEZIMPGSEZImports from SEZ units/developers

​
Other credit APIs

Retrieve ISD credits and TDS deductions:
APITable/CodeDescription
GSTR-2A ISDISDInput Service Distributor credits received
GSTR-2A TDSTDSTax Deducted at Source by deductors

​
Amendment history API

Track changes to inward supplies over time:
APITable/CodeDescription
GSTR-2A AMDHISTAMDHISTAmendment history for tracking supplier changes

​
Common APIs

Shared endpoints used across GSTR-2A workflow:
APIPurpose
Generate OTPStart taxpayer authentication
Verify OTPComplete authentication (6-hour session)
Refresh SessionExtend taxpayer session
LogoutEnd taxpayer session

​
Common use cases

Use GSTR-2A APIs when you need to:
  • Reconcile purchase register against supplier-filed invoices visible in GSTR-2A (vendor-wise mismatch and missing invoice lists)
  • Track amendments to invoices and notes using B2BA, CDNA, ECOMA, and AMDHIST for audit trails
  • Monitor import and SEZ-related inward entries for period-wise ITC reconciliation (IMPG/IMPGSEZ)
  • Capture ISD credits for service-heavy organizations and map them to cost centers
  • Reconcile TDS/TCS credits reflected in GSTR-2A for cashflow and compliance reporting
  • Build monthly inward supplies dashboards with section-wise trends and vendor compliance scores

​
Frequently asked questions

GSTR-2A is an auto-drafted inward supplies statement generated on the GST portal based on documents uploaded by suppliers in their GSTR-1 returns. GSTR-2A contains B2B invoices, credit/debit notes, import entries, ISD credits, TDS/TCS deductions, and e-commerce supplies that are relevant to Input Tax Credit (ITC) claims.
GSTR-2A is a dynamic statement that updates whenever suppliers file or amend their GSTR-1 returns, making it useful for real-time tracking. GSTR-2B is a static statement generated monthly on a GSTN schedule that provides a fixed snapshot for ITC claims. Both statements serve ITC reconciliation but GSTR-2A reflects continuous supplier activity.
GSTR-2A reflects invoices exactly as suppliers file them in GSTR-1. Mismatches occur when suppliers file incorrect invoice numbers, GSTINs, taxable values, or tax amounts. Missing invoices in GSTR-2A indicate that suppliers have not yet filed GSTR-1 for that period. Use the B2B endpoint to retrieve current data and compare against your purchase register.
GSTR-2A API calls require an authenticated taxpayer session. First call the Generate OTP endpoint, then verify with Verify OTP to obtain a session token valid for 6 hours. Include the session token in all subsequent GSTR-2A requests.
GSTR-2A amendment tracking requires multiple endpoints: B2BA for amended B2B invoices, CDNA for amended credit/debit notes, ECOMA for amended e-commerce supplies, and AMDHIST for the complete amendment history log.
GSTR-2A API errors should be handled using standard error codes documented in the error handling guide. Common issues include session expiry (re-authenticate), rate limits (implement backoff), and GST portal downtime (retry with exponential backoff). Always validate the session before making bulk requests.
GSTR-2A is a dynamic statement that updates continuously as suppliers file or amend GSTR-1 returns. Fetch GSTR-2A data after the GSTR-1 filing deadline (11th of the following month) for maximum coverage, and re-fetch periodically to capture late filings and amendments. Monthly reconciliation workflows typically pull data multiple times per period.
GSTR-2A data is available for past return periods subject to GST portal retention policies. Specify the year and month parameters when calling section-wise endpoints like B2B or CDN to retrieve historical inward supplies data for ITC reconciliation and audit purposes.