# Cbic Gst — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Look up current GST tax rates for goods and services, search products and services by classification, browse GST schedules, and stay updated with the latest GST notifications and policy changes from the CBIC portal. Quickly find applicable tax rates for specific items and access real-time updates on what's new in GST regulations.

**Category:** Government & Public Data | **Website:** [cbic-gst.gov.in/](https://cbic-gst.gov.in/) | **Docs:** [parse.bot/marketplace/7ef78be2-3906-478b-b7be-c3534b9ea81b/cbic-gst-gov-in-api](https://parse.bot/marketplace/7ef78be2-3906-478b-b7be-c3534b9ea81b/cbic-gst-gov-in-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-cbic-gst-gov-in-api-7ef78be2/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_gst_goods_rates

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.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-cbic-gst-gov-in-api-7ef78be2/get_gst_goods_rates \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_gst_goods_rates_by_schedule

Get GST rates for Goods filtered by a specific Schedule. Returns all goods entries belonging to the specified schedule.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `schedule` | string | Yes | Schedule identifier to filter by. Accepted values include: I, II, III, IV, V, VI, VII, Nil rate, Compensation Cess. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-cbic-gst-gov-in-api-7ef78be2/get_gst_goods_rates_by_schedule \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"schedule":"<string>"}'
```

### get_gst_notifications

Get recent notifications and circulars from the CBIC GST portal ticker section. Filters ticker items that contain notification numbers (e.g. 'Notification No. 05/2025-Central Excise'). Returns the notification number, full subject text, and link to the advisory PDF when available.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-cbic-gst-gov-in-api-7ef78be2/get_gst_notifications \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_gst_rate_for_item

Get GST rate details for a specific HSN code. Searches the goods rates table for entries containing the exact HSN code.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `hsn_code` | string | Yes | HSN code to look up (e.g. '1001', '0202'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-cbic-gst-gov-in-api-7ef78be2/get_gst_rate_for_item \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"hsn_code":"<string>"}'
```

### get_gst_schedules_list

Get the list of GST Schedules with general rate descriptions. Derives the schedule list from the goods rates table.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-cbic-gst-gov-in-api-7ef78be2/get_gst_schedules_list \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_gst_services_rates

Get the full list of GST rates for Services from the CBIC portal. Returns all service entries with headings, descriptions, and applicable rates.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-cbic-gst-gov-in-api-7ef78be2/get_gst_services_rates \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_whats_new

Get all updates from the 'What's New' ticker section on the CBIC GST portal. Returns announcements, advisories, and notices with optional links to PDF documents. Items are ordered newest first.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-cbic-gst-gov-in-api-7ef78be2/get_whats_new \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_gst_goods

Search GST rates for Goods by keyword. Matches against the description and HSN code fields (case-insensitive substring match).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword to match against goods descriptions or HSN codes (e.g. 'wheat', '1001'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-cbic-gst-gov-in-api-7ef78be2/search_gst_goods \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

### search_gst_services

Search GST rates for Services by keyword. Matches against the description and chapter/section/heading fields (case-insensitive substring match).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword to match against service descriptions or headings (e.g. 'construction', 'transport'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-cbic-gst-gov-in-api-7ef78be2/search_gst_services \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```