GSTR-9 Annual Return API

What is the GSTR-9 Annual Return API?

GSTR-9 is the annual GST return reconciling monthly filings against books of accounts. The WhiteBooks GSTR-9 Filing API accepts the 19-table annual summary JSON and submits to GSTN. It also offers a roll-up helper that pre-fills GSTR-9 tables from your monthly GSTR-1 / GSTR-3B filings.

For taxpayers with turnover above INR 5 Cr (GSTR-9C also required), the API exposes a companion endpoint that accepts the audit reconciliation statement and routes both filings together.

Quick spec

• Endpoint: POST /api/v1/gstr9/file
• Auth: OAuth 2.0 bearer token
• Production base: https://api.whitebooks.in/gst
• Sandbox base: https://apisandbox.whitebooks.in/gst
• Format: JSON in / JSON out
• SLA: 99.99% uptime · p95 < 350ms

Code examples

curl -X POST 'https://apisandbox.whitebooks.in/gst/api/v1/gstr9/file' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{ /* payload */ }'

const res = await fetch('https://apisandbox.whitebooks.in/gst/api/v1/gstr9/file', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer ' + accessToken,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify(payload),
});
const data = await res.json();

import requests

resp = requests.post(
    'https://apisandbox.whitebooks.in/gst/api/v1/gstr9/file',
    headers={'Authorization': f'Bearer {access_token}'},
    json=payload,
)
data = resp.json()

HttpRequest req = HttpRequest.newBuilder()
    .uri(URI.create("https://apisandbox.whitebooks.in/gst/api/v1/gstr9/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

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.

Related GST API endpoints