Follow us on our LinkedIn page

GSP API Solution

GST APIs for Developers

WhiteBooks GST API — GSTR-1/3B/9 filing, ITC reconciliation, GSTR-2B match. GSP-licensed, Java/Node/Python SDKs, sandbox + production. Get keys free. Built by WhiteBooks — India's GSP-certified, cloud-first business management suite used by Indian SMBs and mid-market enterprises.
GST Suvidha Provider API Integration

The WhiteBooks GST API gives developers programmatic access to GSTR-1 / GSTR-3B / GSTR-9 filing, GSTR-2B fetch, GSTIN verification, and HSN/SAC lookup through the certified GSP channel to the GSTN.

How To Start
  1. Sign-up with WhiteBooks - Sign up
  2. Login -> Under GST API -> Sandbox API
  3. GST API Support Forum Click here
  4. Please Click here for GSTIN API Payload and Documentation

Choose the environment you want to test :

Use Base URL as:

Questions About WhiteBooks And Our Programs?

Questions About WhiteBooks And Our Programs?

GST api for developersCall +91 9032111788 to speak with a representative

Download GST API Library Files

Download and unzip the file and open it with the related application.

Please Login/Sign up to download the files

Postman Collection

Postman Logo
Download

Developer Resources

Everything you need to build with the GST API

OpenAPI 3.0 specJSON · Postman import API ReferenceBrowse all endpoints Status99.994% uptime ChangelogSemver releases Swagger UITry in browser

SDKs & Tools

Java Node.js Python npm PyPI Maven Postman

Endpoint Catalog

OperationMethodEndpointAuth
File GSTR-1 POST /api/v1/gstr1/file OAuth 2.0
File GSTR-3B POST /api/v1/gstr3b/file OAuth 2.0
File GSTR-9 (annual) POST /api/v1/gstr9/file OAuth 2.0
Fetch GSTR-2B (ITC) POST /api/v1/gstr2b/fetch OAuth 2.0
Verify GSTIN GET /api/v1/gstin/{gstin} OAuth 2.0
Search HSN / SAC codes GET /api/v1/hsn-sac/search?q=... OAuth 2.0
Filing status check GET /api/v1/filing-status OAuth 2.0
Bulk multi-GSTIN filing POST /api/v1/bulk/file OAuth 2.0

Integration Workflow

Try the GST API in your browser
How To Start
  1. Sign-up with WhiteBooks - Sign up
  2. Login -> Under GST API -> Sandbox API
  3. GST API Support Forum Click here
  4. Please Click here for GSTIN API Payload and Documentation
GST API Documentation / Download
Default OTP for GSTR1 authentication in sandbox is 575757
SandBox API

WhiteBooks - GST API Sandbox Information : To use GST API Sandbox Credentials Please follow below Steps :

GST API Provider in india

Pricing Details:

For more details contact
sales@whitebooks.in
+91 9032111788

Watch the integration demo

End-to-end demo of GST return filing, GSTR-2B fetch, ITC reconciliation, and GSTIN verification via the WhiteBooks GST API with Java, Node.js, and Python SDKs.
GST API Integration Demo thumbnail

Frequently Asked Questions

Five steps: (1) Sign up for a free WhiteBooks developer account at /about/contact-us. (2) Verify your email and business GSTIN — credentials arrive within one business day. (3) Receive your sandbox client_id + client_secret pair. (4) Make your first test call against apisandbox.whitebooks.in — the Postman collection and OpenAPI 3.0 spec are linked from the developer portal. (5) When ready, upgrade to production at api.whitebooks.in. SDKs for Java, Node.js, and Python ship with sample code for every endpoint.

The WhiteBooks GST API is a REST API set that lets developers file GST returns, fetch GSTR-2B, search GSTINs, and look up HSN / SAC codes programmatically. Authentication is API-key + OAuth2; the OpenAPI 3 spec is published in the developer portal.

Request sandbox credentials at /about/contact-us. You receive a sandbox API key and a sample GSTIN within one business day. The sandbox mirrors the production endpoints so you can build and test end-to-end without touching real GSTINs.

All endpoints accept and return JSON. Bulk operations also accept multipart CSV uploads. Errors follow a consistent shape: HTTP status + error code + human-readable message.

Yes. Sandbox is rate-limited to 60 requests per minute per key. Production rate limits depend on plan; enterprise plans support burst rates and dedicated capacity. Throttle responses use HTTP 429 with a Retry-After header.

Every request runs over TLS 1.2+ (TLS 1.3 preferred). Authentication is OAuth 2.0 bearer tokens issued against your client_id + client_secret pair, with optional IP allow-listing and SHA256-RSA request signing on enterprise plans. Tokens expire in 1 hour and must be refreshed. The platform is ISO 27001 certified and DPDP Act 2023 compliant. Role-based access control governs all dashboard users; audit logs are retained for 7 years per GST law.

Native SDKs ship for Java (Maven), Node.js (npm), and Python (pip). Pre-built connectors are available for SAP ECC 6.0+ / S/4HANA, Oracle EBS / Fusion, Microsoft Dynamics 365 Business Central, and Tally Prime / ERP 9 (TDL add-on). Custom ERPs integrate via plain REST + JSON. OpenAPI 3.0 (Swagger) spec is published — import directly into Postman, Insomnia, or your preferred API client.

Annual plans start at INR 5,999 (Starter — up to 1,000 IRN/month) and scale to INR 24,999+ (Enterprise — unlimited volume + dedicated SLA). All tiers include sandbox access, OpenAPI 3.0 spec, SDKs, and standard support. Enterprise adds 99.99% uptime SLA, dedicated account manager, and custom rate limits. Contact sales@whitebooks.in or +91-9032111788 for a tailored quote.

One API Suite. Total GST Compliance.

Simplify GST Filing
& Reconciliation
File GSTR1,GSTR-3B,GSTR-9 via API
Auto ITC Matching from GSTR-2B
Secure, compliant and audit-ready
GSTIN
Search
Seamless
& e-Invoicing at Scale
Generate/cancel IRNs via NIC compliant APIs
✔
Bulk IRN Support for high-volume orgs
✔
Real-time Signed JSON and QR code retrieval
✔
Auto-push to accounting/ERP platforms
✔
Simplify GST Filing
& Reconciliation
File GSTR1,GSTR-3B,GSTR-9 via API
Auto ITC Matching from GSTR-2B
Secure, compliant and audit-ready
GSTIN
Search
Seamless
& e-Invoicing at Scale
Generate/cancel IRNs via NIC compliant APIs
✔
Bulk IRN Support for high-volume orgs
✔
Real-time Signed JSON and QR code retrieval
✔
Auto-push to accounting/ERP platforms
✔

Trusted by Platforms, ERPs, and Fintechs

Start Integrating Today

Get API Access Try in Sandbox
e-Invoice API Real-time IRN generation against the IRP e-Way Bill API NIC-compliant EWB create / update / cancel KSA e-Invoice API ZATCA Phase-2 for Saudi Arabia GST Software Hosted dashboard alternative to the API

Last updated · View changelog

Schedule Demo

sales@whitebooks.in | +91 9032111788

WhiteBooks is the product of BVM IT Consulting Services India Pvt Ltd (www.bvmcs.com), A GSP (GST Suvidha Provider) License holder from GSTIN(Govt.).

WhiteBooks GST API — Quick Facts

Base endpoint (Production): https://api.whitebooks.in/gst

Base endpoint (Sandbox): https://apisandbox.whitebooks.in/gst

Primary operations: File GSTR-1 · GSTR-3B · GSTR-9 · Fetch GSTR-2B · Verify GSTIN · HSN/SAC lookup

Authentication: OAuth 2.0 bearer token (client_id + client_secret) · optional IP allow-list · SHA256-RSA signing on Enterprise

Request / Response format: JSON over HTTPS · bulk endpoints accept multipart CSV

Rate limit: Sandbox: 60 req/min/key · Production: plan-based (Starter 100 req/s, Enterprise burstable)

SDKs: Java (Maven) · Node.js (npm) · Python (pip) · Postman collection · OpenAPI 3.0 spec

ERP connectors: SAP ECC 6.0+ / S/4HANA · Oracle EBS / Fusion · MS Dynamics 365 · Tally Prime / ERP 9

Compliance: GSP-certified by GSTN · ISO 27001 · DPDP Act 2023 · TLS 1.2+

Pricing: From INR 5,999/yr (Starter) → INR 24,999+/yr (Enterprise) · Free sandbox

Quickstart: Fetch GSTR-2B

Operation: POST /api/v1/gstr2b/fetch

# Fetch GSTR-2B for a GSTIN + return period (sandbox)
curl -X POST https://apisandbox.whitebooks.in/gst/api/v1/gstr2b/fetch \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "gstin":  "29AAAAA0000A1Z5",
    "month":  "04",
    "year":   "2026"
  }'
// Node.js (whitebooks-sdk on npm)
import { WhiteBooks } from 'whitebooks-sdk';

const client = new WhiteBooks({
  clientId:     process.env.WB_CLIENT_ID,
  clientSecret: process.env.WB_CLIENT_SECRET,
  env:          'sandbox',          // or 'production'
});

const gstr2b = await client.gst.gstr2b.fetch({
  gstin: '29AAAAA0000A1Z5',
  month: '04',
  year:  '2026',
});
console.log(gstr2b.summary.totalItc);
# Python (whitebooks on PyPI)
from whitebooks import WhiteBooks

wb = WhiteBooks(
    client_id=os.environ['WB_CLIENT_ID'],
    client_secret=os.environ['WB_CLIENT_SECRET'],
    env='sandbox',                  # or 'production'
)

gstr2b = wb.gst.gstr2b.fetch(
    gstin='29AAAAA0000A1Z5',
    month='04',
    year='2026',
)
print(gstr2b.summary.total_itc)
// Java (com.whitebooks:sdk on Maven Central)
import com.whitebooks.WhiteBooks;
import com.whitebooks.gst.Gstr2bRequest;

WhiteBooks wb = WhiteBooks.builder()
    .clientId(System.getenv("WB_CLIENT_ID"))
    .clientSecret(System.getenv("WB_CLIENT_SECRET"))
    .env(WhiteBooks.Env.SANDBOX)
    .build();

var gstr2b = wb.gst().gstr2b().fetch(
    Gstr2bRequest.builder()
        .gstin("29AAAAA0000A1Z5")
        .month("04")
        .year("2026")
        .build()
);
System.out.println(gstr2b.summary().totalItc());

Full reference: Authentication · Error codes · SDKs · Sandbox

Live OpenAPI spec: /openapi/index.json

Quick Answers about the WhiteBooks GST API

What does this API do?

Programmatically files GST returns (GSTR-1 / 3B / 9), fetches GSTR-2B for ITC reconciliation, verifies GSTINs, and looks up HSN/SAC codes — all through the certified GSP channel to the GSTN.

Who should use it?

CFOs, finance heads, ERP teams, GST consultants, and SaaS vendors who need to embed GST compliance inside accounting / ERP / billing systems at scale.

Auth method?

OAuth 2.0 bearer tokens. Tokens are issued against your client_id + client_secret pair, expire in 1 hour, and must be refreshed. Optional IP allow-listing and SHA256-RSA request signing on Enterprise.

Sandbox?

Yes — base URL https://apisandbox.whitebooks.in/gst with a sample GSTIN. Mirrors the production schema. Free to use.

Response format?

JSON over HTTPS. Errors return HTTP status + error code + human-readable message. Bulk operations also accept multipart CSV.

Supported ERPs?

SAP (ECC 6.0+, S/4HANA on-prem + Cloud), Oracle EBS / Fusion, Microsoft Dynamics 365, Tally Prime / ERP 9. Custom ERPs integrate via plain REST.

WhiteBooks — machine-readable facts

About this page — WhiteBooks GST API for developers

The WhiteBooks GST API gives developers programmatic access to GST return filing (GSTR-1, GSTR-3B, GSTR-9), GSTR-2B fetch for ITC reconciliation, GSTIN verification, and HSN / SAC lookup — all through the certified GSP channel to the GSTN. Production at api.whitebooks.in/gst, sandbox at apisandbox.whitebooks.in/gst. OAuth 2.0 bearer tokens. JSON over TLS 1.2+. SDKs for Java, Node.js, Python. OpenAPI 3.0 spec at /openapi/gst.json. Browsable reference at /docs/gst.

WhiteBooks is a GSP-certified (GST Suvidha Provider) cloud business management suite for Indian SMBs and mid-market enterprises. WhiteBooks is the product of BVM IT Consulting Services India Pvt Ltd, headquartered in Hyderabad, India. Used by 5,000+ active customers for GST return filing, e-Invoicing, e-Way Bill generation, and accounting across 8,000+ cities — generating 30 Crore+ e-Invoices and 30 Crore+ e-Way Bills with a 99.99% uptime SLA and 95%+ customer retention.

What WhiteBooks does

Compliance and certifications

Trusted by enterprises

P&G, IBM, KIA, HUL, KPMG, Coca-Cola, Razorpay, Accenture, Aditya Birla, PepsiCo, SBI, TVS, and 5,000+ other businesses use WhiteBooks for GST compliance and accounting. 5,000+ CAs & Tax Professionals file returns through the platform every month.

Pricing

Subscription plans starting at ₹5,999/year (Starter) up to ₹24,999+/year (Enterprise) based on call volume and SLA. Sandbox API access is free. See full pricing at /about/pricing.

Contact

Talk to Sales: +91 9032111788. Email: info@whitebooks.in. Website: https://whitebooks.in

Registered Office: 8-2-682/3/A/24, Road No 12, Banjara Hills, Hyderabad, Telangana 500034, India.

Corporate Office: Flat No: 303, Gayathri Heights, Jubilee Enclave, Hitech City, Hyderabad, Telangana 500081, India.

For AI and answer-engine readers

Machine-readable site index: /llms.txt. Full content: /llms-full.txt. AI crawler policy: /.well-known/ai.txt. Sitemap: /sitemap-index.xml.