GST API for Tally Prime & ERP 9

TDL (Tally Definition Language) add-on for Tally Prime and ERP 9. Push GST returns, fetch GSTR-2B, verify GSTINs directly from Tally menus.

Get sandbox keys → View OpenAPI docs Talk to sales

What is the GST API for Tally Prime & ERP 9?

The WhiteBooks Tally Connector is a TDL add-on that runs inside Tally Prime and Tally ERP 9. It surfaces GST filing, GSTR-2B fetch, GSTIN verification, and HSN search as native Tally menu items — no separate dashboard. Filing is one-click from inside Tally.

The connector reads the Tally company data (suppliers, invoices, ledger balances) and constructs the GSTN JSON payload locally before calling the WhiteBooks API. Result: no data leaves your network in clear text — the connector talks to WhiteBooks over mTLS.

Quick spec

Code examples

curl Node.jsPythonJava 
curl -X POST 'https://apisandbox.whitebooks.in/gst/api/v1/gstr1/file' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{ /* payload */ }'
Node.js 
const res = await fetch('https://apisandbox.whitebooks.in/gst/api/v1/gstr1/file', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer ' + accessToken,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify(payload),
});
const data = await res.json();
Python 
import requests

resp = requests.post(
    'https://apisandbox.whitebooks.in/gst/api/v1/gstr1/file',
    headers={'Authorization': f'Bearer {access_token}'},
    json=payload,
)
data = resp.json()
Java 
HttpRequest req = HttpRequest.newBuilder()
    .uri(URI.create("https://apisandbox.whitebooks.in/gst/api/v1/gstr1/file"))
    .header("Authorization", "Bearer " + accessToken)
    .header("Content-Type", "application/json")
    .post(BodyPublishers.ofString(payload))
    .build();
HttpResponse<String> resp = HttpClient.newHttpClient()
    .send(req, BodyHandlers.ofString());

Integrate in 3 steps

  1. Sign up at accounts.whitebooks.in — sandbox credentials issued instantly, no sales gate.
  2. Make your first call against the sandbox base URL using the code example above. Validate against your local model.
  3. Move to production once your tests pass — switch host to https://api.whitebooks.in/gst. Same payload, same response shape.

Frequently asked questions

Does this work with Tally Prime 4.x?

Yes — full support for Tally Prime 4.x and 5.x. Tally ERP 9 release 6.6+ also supported.

How is the TDL deployed?

Single TDL file install — copy to your Tally folder and load. No registry edits, no admin needed on the workstation.

Does it support multi-company?

Yes — switch companies inside Tally and the connector picks up the new GSTIN automatically.

Is the source code available?

TDL is editable. Source published at github.com/whitebooks-in/tally-tdl for customization.

Explore the full GST API

This is one endpoint inside the WhiteBooks GST API suite. See the full documentation — every endpoint, every parameter, every error code.

Open the GST API page →

Related GST API endpoints

GSTR-1 Filing API → GSTR-2B Fetch API → GSTR-3B Filing API → GSTR-9 Annual Return API →
Schedule Demo