Bulk GST Filing APIs for CA Firms — One Token, 250+ Clients, Zero OTP Fatigue
5,000+ CAs already file through WhiteBooks. One dashboard, all client GSTINs, monthly batch filing.
Free 30-day trial for CA firms — onboard your full client list in a single CSV
The problem
For Partner / Compliance Lead at a CA firm or accounting outsourcing shop. You file GSTR-1 / 3B / 9 for 250+ clients every month. OTP fatigue is brutal. The portal locks you out. Junior staff make data-entry errors that cost the firm.
How WhiteBooks solves it
- One OAuth token across the entire client master — no per-client login, no OTP, no portal lockout.
- Batch GSTR-1 / 3B filing across all clients in a single dashboard sweep with per-client pre-validation.
- Role-based access: junior staff prepares, reviewer approves, partner files — every action is audit-logged.
- Client master cleanup with bulk GSTIN verification — flag dormant or cancelled GSTINs before filing.
Key APIs
| Tool / Endpoint | What it does | Path |
|---|---|---|
gst.verify_gstin_bulk | Client master cleanup | /api/v1/gstin/bulk-verify |
gst.fetch_gstr2b | Per client, parallelisable | /api/v1/gstr2b/fetch |
gst.file_gstr1 | Batch monthly filing | /api/v1/gstr1/file |
gst.file_gstr3b | Batch monthly summary filing | /api/v1/gstr3b/file |
rbac.assign_role | Junior / reviewer / partner | /api/v1/rbac/assign |
Compliance angle
GST-PM compliance for tax practitioners, client data isolation, audit trail per filer (junior / reviewer / partner), super-user controls, GSTN consent each session.
Live numbers
- Throughput: 1,000 invoices / EWBs per single API call (bulk mode).
- Latency: p50 87 ms IRN, p95 312 ms — live at whitebooks.in/status.
- Uptime: 99.994% rolling 30-day; 99.99% SLA with credits on Enterprise.
- Region: Mumbai + Hyderabad active-active; KSA in
me-south-1.
Sample architecture
Sample customer pattern
A mid-tier CA firm with 11 partners files monthly returns for 312 clients. Juniors prepare in WhiteBooks, reviewers approve via in-platform e-sign, partners file in batch on the 18th of each month. Audit trail per action is retained for 7 years.
Frequently asked questions
Can one OAuth token act on behalf of 250+ client GSTINs?
Yes. The CA Firm OAuth model lets you register your firm once; each client GSTIN is added as a sub-scope. No per-client login. No OTP fatigue. Filings carry your firm's acting-on-behalf metadata so the GSTN audit trail names both filer and client.
How are junior staff prevented from filing without partner approval?
Role-based access: juniors get prepare-only, reviewers get approve, partners get file. Filing endpoints reject calls from a token without the file scope. Every action (prepare, approve, file) is audit-logged with timestamp + actor + IP.
Can we batch-file GSTR-1 / 3B for 100 clients at once?
Yes. gst.file_gstr1 and gst.file_gstr3b accept batch arrays — up to 50 GSTR-1s or 100 GSTR-3Bs per call. Per-client validation runs before the GSTN call so a single bad payload doesn't fail the batch.
Do you support GSTR-9 batch annual filing?
Yes. gst.file_gstr9 supports batch mode. Annual filing benefits from a pre-flight reconciliation that compares the year's monthly filings against the books — mismatches surface before the GSTR-9 is filed.
How is pricing structured for a CA firm with 250 clients?
CA-firm pricing is per-client-per-year tiers: ₹2,400 / client / yr for 50+ clients with volume discount above 100. Starts at ₹5,999 base + per-client fee. Talk to sales for the firm-pricing schedule.
Get started
Related use cases: Logistics · Retail · Manufacturing · Fintech · Pharma · E-Commerce · SaaS · CA Firms · ERP Providers
Reference: All APIs hub · /docs/gst · /docs/einvoice · /docs/eway · Pricing · Architecture · Status · Changelog