SAC Code Lookup API

Lookup Services Accounting Codes (SAC) for service classification. Returns SAC code, description, and current GST rate.

Get sandbox keys → View OpenAPI docs Talk to sales

What is the SAC Code Lookup API?

The SAC Code Lookup API exposes the Services Accounting Code master used for GST classification of services. Pass either a code prefix (4-6 digits) or a description (e.g., "consulting") and receive structured results: code, description, igst_rate.

Service businesses use this for invoice creation, e-Invoice payload preparation (SAC is mandatory for services above INR 5 lakh), and vendor onboarding when a new service is being procured.

Quick spec

Code examples

curl Node.jsPythonJava 
curl -X GET 'https://apisandbox.whitebooks.in/gst/api/v1/hsn-sac/search?type=sac' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json'
Node.js 
const res = await fetch('https://apisandbox.whitebooks.in/gst/api/v1/hsn-sac/search?type=sac', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer ' + accessToken,
    'Content-Type': 'application/json',
  },
});
const data = await res.json();
Python 
import requests

resp = requests.get(
    'https://apisandbox.whitebooks.in/gst/api/v1/hsn-sac/search?type=sac',
    headers={'Authorization': f'Bearer {access_token}'},
)
data = resp.json()
Java 
HttpRequest req = HttpRequest.newBuilder()
    .uri(URI.create("https://apisandbox.whitebooks.in/gst/api/v1/hsn-sac/search?type=sac"))
    .header("Authorization", "Bearer " + accessToken)
    .header("Content-Type", "application/json")
    .GET()
    .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

How many SAC codes exist?

Over 700 codes covering all major service categories. The full list is downloadable via /api/v1/hsn-sac/dump?type=sac.

Is the GST rate included?

Yes — every entry includes the applicable igst_rate. Most services attract 18%; exemptions are flagged.

Can I filter by GST rate?

Yes — pass rate=18 to fetch all SACs at 18%, or rate=exempt for exempt services.

Are place-of-supply rules included?

Yes — each SAC includes the GST place-of-supply rule reference for inter-state vs intra-state determination.

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