Verify a GST-registered business by its 15-character GSTIN. Returns legal/trade name, status, taxpayer type, constitution, e-invoice enablement, and registered address. No taxpayer session required.

Find all GSTINs registered against a PAN across states. Useful to discover a business's registrations. No taxpayer session required.

Check the GST return filing status/history for a GSTIN (GSTR-1, GSTR-3B, etc.). Optionally filter by financial year (e.g. 2025-26). No taxpayer session required.

Step 1 of a taxpayer session. Sends an OTP to the taxpayer's GST-registered mobile/email. Uses GST_USERNAME/GST_GSTIN from config unless overridden. Requires API access enabled on gst.gov.in.

Step 2 of a taxpayer session. Verifies the OTP and starts a ~6-hour taxpayer session held in memory for subsequent taxpayer_* / get_gstr* / ledger tools.

Reports whether an active taxpayer session exists in this server process.

Fetch GSTR-3B (monthly summary return) details for a return period. Requires an active taxpayer session.

Fetch GSTR-2B (auto-drafted ITC statement of purchases) for a return period. Requires an active taxpayer session.

List the authenticated taxpayer's filed/pending returns for a return period. Requires an active taxpayer session.

Fetch the authenticated taxpayer's Annual Aggregate Turnover values. Requires an active taxpayer session.

Fetch the taxpayer's Cash and ITC ledger balances as on a return period (year/month). Requires an active taxpayer session.

Fetch the electronic cash ledger transactions for a date range. Requires an active taxpayer session.

Fetch the electronic Input Tax Credit (ITC) ledger transactions for a date range. Requires an active taxpayer session.