cbic-gst.gov.in APIcbic-gst.gov.in ↗
Access GST rates for goods and services, HSN code lookups, schedule filtering, and CBIC notifications via a structured JSON API.
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'
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 cbic-gst.gov.in API
This API exposes 9 endpoints covering GST rate data and policy updates from the CBIC GST portal (cbic-gst.gov.in). You can retrieve the full goods and services rate tables — each entry including CGST, SGST/UTGST, and IGST rates — search by keyword or HSN code, filter by schedule, and pull the latest notifications and portal updates via get_gst_notifications and get_whats_new.
GST Rate Data for Goods and Services
get_gst_goods_rates returns every goods entry published in the CBIC rate schedule, with fields for schedule, s_no, hsn_code, description, cgst_rate, sgst_utgst_rate, igst_rate, and compensation_cess. get_gst_services_rates returns the parallel table for services, swapping hsn_code for chapter_section_heading and adding a condition field that captures applicability conditions attached to specific service entries. Neither endpoint requires any input parameters.
Search and Schedule Filtering
search_gst_goods and search_gst_services both accept a single query string and perform case-insensitive substring matching against description and classification fields. This lets you look up a commodity like 'wheat' or a service like 'construction' without knowing exact HSN codes or headings. get_gst_rate_for_item accepts an hsn_code parameter and returns all goods entries where the code matches exactly — useful when you have a precise classification. get_gst_goods_rates_by_schedule filters the goods table by schedule identifier (Roman numerals I through VII, or labels like Nil rate and Compensation Cess), and get_gst_schedules_list returns the derived list of schedule names alongside their rate descriptions.
Notifications and Portal Updates
get_whats_new returns items from the CBIC portal's homepage ticker as objects with content (plain text) and url (link to a PDF document or null). get_gst_notifications filters that same feed to entries that contain notification numbers, returning structured objects with notification_no, subject, and url. These two endpoints are the practical way to monitor regulatory changes without polling the portal manually.
- Building an invoicing or accounting tool that auto-fills CGST, SGST, and IGST rates from an HSN code lookup
- Populating a product catalog with correct GST classification by searching descriptions via
search_gst_goods - Alerting a compliance team when new GST notifications appear by polling
get_gst_notifications - Generating a schedule-wise rate reference table for a tax advisory dashboard using
get_gst_goods_rates_by_schedule - Verifying compensation cess applicability on specific goods by inspecting the
compensation_cessfield - Monitoring CBIC portal announcements in a daily digest using
get_whats_new - Cross-checking service tax applicability conditions through the
conditionfield returned byget_gst_services_rates
| 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 | 250 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 does it differ from `search_gst_goods`?+
get_gst_rate_for_item matches the hsn_code field exactly against the value you supply, returning only entries where the code is that specific string. search_gst_goods does a substring match across both the description and hsn_code fields, so it is better suited for exploratory lookups when you know a keyword or partial code but not the exact classification.Does the API return historical GST rate data or rate change history?+
Are customs duty rates or import tariff data available through this API?+
How fresh is the notification data returned by `get_gst_notifications`?+
get_gst_notifications on a scheduled basis and diffing the notification_no values is a reliable approach to detect new entries.