Gov APIcbic-gst.gov.in ↗
Access GST rates for goods and services, HSN code lookups, schedule browsing, and latest CBIC notifications via a structured JSON API.
What is the Gov API?
This API exposes 9 endpoints covering GST rate data and regulatory updates from the CBIC GST portal (cbic-gst.gov.in). You can retrieve the full goods and services rate tables, filter by HSN code or schedule, run keyword searches against descriptions, and pull the latest announcements from the portal's What's New section — all returning structured JSON with fields like cgst_rate, igst_rate, hsn_code, and notification_no.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/28e7c747-a93a-4cf5-9378-687c13c04859/get_gst_goods_rates' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace cbic-gst-gov-in-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: CBIC GST Portal SDK — bounded, re-runnable."""
from parse_apis.cbic_gst_portal_api import CBIC, NotFoundError
cbic = CBIC()
# List portal updates (advisories, notices) — newest first
for update in cbic.updates.list(limit=5):
print(update.content[:100], update.url)
# List notifications with extracted notification numbers
first_notification = cbic.notifications.list(limit=1).first()
if first_notification:
print(first_notification.notification_no, first_notification.subject[:80], first_notification.url)
# Typed error handling around a list call
try:
for notification in cbic.notifications.list(limit=3):
print(notification.notification_no, notification.subject[:60])
except NotFoundError as exc:
print(f"not found: {exc}")
print("exercised: updates.list / notifications.list")
Get the full list of GST rates for Goods from the CBIC portal. Returns all goods entries across all schedules with HSN codes, descriptions, and applicable rates.
No input parameters required.
{
"type": "object",
"fields": {
"data": "array of goods rate objects with schedule, s_no, hsn_code, description, cgst_rate, sgst_utgst_rate, igst_rate, compensation_cess",
"status": "string, always 'success'"
},
"sample": {
"data": [
{
"s_no": "1",
"hsn_code": "0202, 0203,0204, 0205,0206, 0207,0208, 0209,0210",
"schedule": "I",
"cgst_rate": "2.5%",
"igst_rate": "5%",
"description": "All goods [other than fresh or chilled] pre-packaged and labelled.",
"sgst_utgst_rate": "2.5%",
"compensation_cess": ""
}
],
"status": "success"
}
}About the Gov API
GST Rate Data for Goods and Services
get_gst_goods_rates returns the complete goods rate table as an array of objects, each carrying schedule, s_no, hsn_code, description, cgst_rate, sgst_utgst_rate, igst_rate, and compensation_cess. The parallel endpoint get_gst_services_rates covers services, replacing HSN fields with chapter_section_heading and adding a condition field that captures any applicability conditions attached to a rate entry. Both endpoints return the full dataset in a single call with no pagination.
Search and Schedule Filtering
search_gst_goods and search_gst_services accept a query string and perform case-insensitive substring matching against description and classification fields, making it straightforward to find rate entries for a product category or keyword like 'wheat' or 'construction'. For goods, get_gst_goods_rates_by_schedule narrows results to a single schedule using the schedule parameter — accepted values include Roman numerals I through VII, Nil rate, and Compensation. get_gst_rate_for_item looks up entries by exact hsn_code, returning all goods rows that match that code.
Schedules List and Portal Updates
get_gst_schedules_list derives a deduplicated list of schedule identifiers and their rate labels directly from the goods table, giving a quick reference for valid schedule parameter values. get_whats_new returns the full contents of the portal's announcement ticker — each item has a content field with the announcement text and a url field pointing to an associated PDF, or null if none is linked. Items are ordered newest first.
Notifications and Circulars
get_gst_notifications filters the ticker specifically for entries that contain a notification number pattern (e.g. Notification No. 05/2025-Central Excise). Each result object exposes notification_no (the extracted reference), subject (the full announcement text), and url for the linked PDF when available. This endpoint is useful for tracking new circulars and policy changes without parsing the full What's New feed manually.
The Gov API is a managed, monitored endpoint for cbic-gst.gov.in — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when cbic-gst.gov.in changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official cbic-gst.gov.in API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a GST rate calculator that looks up CGST and IGST rates by HSN code using
get_gst_rate_for_item. - Populate a product compliance tool with full goods and services rate tables via
get_gst_goods_ratesandget_gst_services_rates. - Alert finance teams to new CBIC circulars by polling
get_gst_notificationsfor newnotification_noentries. - Let users search applicable GST rates by product keyword using
search_gst_goodsagainst description and HSN fields. - Build a schedule-by-schedule GST reference guide using
get_gst_schedules_listcombined withget_gst_goods_rates_by_schedule. - Monitor CBIC portal announcements in a dashboard by consuming the
contentandurlfields fromget_whats_new. - Validate HSN code classifications against the official CBIC goods table during ERP or accounting software onboarding.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does CBIC provide an official developer API for GST rate data?+
What does `get_gst_rate_for_item` return, and how exact does the HSN code match need to be?+
hsn_code field contains the value you supply. It is a substring-style match, so passing '1001' will return entries whose HSN code includes that string. If multiple goods share overlapping codes, multiple rows are returned. The response fields are identical to the full goods table: schedule, s_no, hsn_code, description, cgst_rate, sgst_utgst_rate, igst_rate, and compensation_cess.Do the rate endpoints reflect real-time updates when CBIC revises rates?+
get_gst_notifications.