GST API for Oracle NetSuite & EBS

What is the GST API for Oracle NetSuite & EBS?

For Oracle NetSuite customers, WhiteBooks ships a published SuiteApp (available on SuiteCloud Developer Network) that maps NetSuite's standard GST Compliance module to the WhiteBooks GSTR JSON schema. Returns are filed with a single click from Reports → GST → File Returns.

For Oracle E-Business Suite (EBS) 12.x customers, a Java-based concurrent program exposes WhiteBooks API calls as OAF actions. Both connectors share the same backend API so feature parity is guaranteed across Oracle product variants.

Quick spec

• Endpoint: POST /api/v1/gstr1/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/gstr1/file' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{ /* payload */ }'

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();

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()

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

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