FastGST GST Tax Rates API Usage Documentation

FastGST simplifies GST tax rate integration by aggregating publicly available GST data into a single API.

Get API Key and Manage Access: https://consoledesk.in

Plans & Pricing: https://www.fastgst.in/pricing/

Base URL https://api.taxlookup.fastgst.in

Authentication: All endpoints need authentication. Get API Key from ConsoleDesk first. Pass your access key in the X-API-Key HTTP header.

Note: Before using the API, activate the API in ConsoleDesk and choose a plan that suits your requirements. Once the plan is active, create an API Key and start using the service and monitor usage in ConsoleDesk.

HSN Endpoints

HSN endpoints can be used to lookup GST info for Goods.

GET /search/hsn

Search HSN codes with hierarchical grouping

Search HSN codes by keyword and get results grouped by headings with their sub-items. Returns top 6 headings, each with up to 6 matched sub-items. No pagination. Use this to find HSN codes, then use /search/hsn/{code}/taxes to get tax information.

Parameter	Description
query Required	The descriptive keyword to search for (e.g., "rice"). Do not pass numeric codes here.

Sample Request

curl -X 'GET' \
  'https://api.taxlookup.fastgst.in/search/hsn?query=rice' \
  -H 'accept: */*' \
  -H 'X-API-Key: FGST_TEST_************************'

Sample Response

{
  "success": true,
  "data": [
    {
      "hierarchy": "1006",
      "description": "Wheat And Meslin.",
      "match_score": 0.98,
      "matches": [
        {
          "hsn_code": "10063010",
          "description": "Rice Parboiled",
          "match_score": 0.98
        },
        {
          "hsn_code": "10063011",
          "description": "Rice, Gi Recognised",
          "match_score": 0.98
        }
      ]
    },
    {
      "hierarchy": "1102",
      "description": "Cereal Flours Other Than Of Wheat Or Meslin.",
      "match_score": 0.95,
      "matches": [
        {
          "hsn_code": "11023000",
          "description": "Cereal Flours Other Than That Of Wheat Or Meslin Rice Flour",
          "match_score": 0.95
        },
        {
          "hsn_code": "11029021",
          "description": "Brown Rice Flour",
          "match_score": 0.95
        }
      ]
    }
  ],
  "meta": {
    "api_version": "v1",
    "timestamp": "2026-04-07",
    "request_id": "req_0HNKKS1B9IQEQ:00000001"
  }
}

GET /search/hsn/{code}

Search HSN by exact code

Look up exact HSN code and get basic information (code, description, hierarchy) without tax rates.

Parameter	Description
code Required	6-digit (Intl. WCO std) or 8-digit (Indian Customs std) numeric HSN code.

Sample Request

curl -X 'GET' \
  'https://api.taxlookup.fastgst.in/search/hsn/11029021' \
  -H 'accept: */*' \
  -H 'X-API-Key: FGST_TEST_************************'

Sample Response

{
  "success": true,
  "data": {
    "hsn_code": "11029021",
    "schedule": "Schedule I",
    "description": "Brown Rice Flour",
    "hierarchy": {
      "section": {
        "code": "06-14",
        "description": "II Vegetable Products"
      },
      "chapter": {
        "code": "11",
        "description": "Cereal Flours Other Than Of Wheat Or Meslin."
      },
      "heading": {
        "code": "1102",
        "description": "General"
      },
      "sub_heading": {
        "code": "110290",
        "description": "Others"
      },
      "tariff_item": {
        "code": "11029021",
        "description": "Brown Rice Flour"
      }
    }
  },
  "meta": {
    "api_version": "v1",
    "timestamp": "2026-04-07",
    "request_id": "req_0HNKKS1B9IQER:00000001"
  }
}

GET /search/hsn/{code}/taxes

Get HSN tax information by code

Look up exact HSN code and get only tax rate information (CGST, SGST, IGST).

Parameter	Description
code Required	Exact 6-digit or 8-digit numeric HSN code.

Sample Request

curl -X 'GET' \
  'https://api.taxlookup.fastgst.in/search/hsn/11029021/taxes' \
  -H 'accept: */*' \
  -H 'X-API-Key: FGST_TEST_************************'

Sample Response

{
  "success": true,
  "data": {
    "gst_rate": 5,
    "gst_breakdown": {
      "cgst": 2.5,
      "sgst": 2.5,
      "igst": 5
    },
    "cess_breakdown": "No Compensation Cess Applicable",
    "cess_detail": "No Compensation Cess Applicable",
    "is_exempted": false,
    "exemption_status": "Taxable",
    "broad_categeory": "v1.0",
    "last_updated": "2025-09-17",
    "schedule": "Schedule I",
    "source": "Notification No. 17/2025–Central Tax (Rate), 17/2025-CT(Rate), 2025-10-01, Amends Multiple Notifications, CGST Rate Clarifications, Central Tax"
  },
  "meta": {
    "api_version": "v1",
    "timestamp": "2026-04-07",
    "request_id": "req_0HNKKS1B9IQES:00000001"
  }
}

SAC Endpoints

SAC endpoints can be used to lookup GST info for Services.

GET /search/sac

Search SAC codes with hierarchical grouping

Search XML-based SAC data by descriptive keyword. Returns hierarchically mapped SAC codes.

Parameter	Description
query Required	The descriptive keyword to search for (e.g., "software", "consulting").

Sample Request

curl -X 'GET' \
  'https://api.taxlookup.fastgst.in/search/sac?query=software' \
  -H 'accept: */*' \
  -H 'X-API-Key: FGST_TEST_************************'

Sample Response

{
  "success": true,
  "data": [
    {
      "hierarchy": "9983",
      "description": "Other professional, technical and business services",
      "match_score": 0.95,
      "matches": [
        {
          "sac_code": "998314",
          "description": "Information technology (IT) design and development services",
          "match_score": 0.95
        },
        {
          "sac_code": "998315",
          "description": "Hosting and information technology (IT) infrastructure provisioning services",
          "match_score": 0.92
        }
      ]
    }
  ],
  "meta": {
    "api_version": "v1",
    "timestamp": "2026-04-07",
    "request_id": "req_0HNKKS1B9IQET:00000001"
  }
}

GET /search/sac/{code}

Search SAC by exact code

Lookup basic information for an exact SAC code. Response includes textual description but excludes tax condition logic.

Parameter	Description
code Required	Exact numeric SAC code (starting with 99).

Sample Request

curl -X 'GET' \
  'https://api.taxlookup.fastgst.in/search/sac/998314' \
  -H 'accept: */*' \
  -H 'X-API-Key: FGST_TEST_************************'

Sample Response

{
  "success": true,
  "data": {
    "sac_code": "998314",
    "description": "Information technology (IT) design and development services",
    "hierarchy": {
      "heading": {
        "code": "9983",
        "description": "Other professional, technical and business services"
      },
      "group": {
        "code": "99831",
        "description": "Management consulting and management services; information technology services"
      }
    }
  },
  "meta": {
    "api_version": "v1",
    "timestamp": "2026-04-07",
    "request_id": "req_0HNKKS1B9IQEU:00000001"
  }
}

GET /search/sac/{code}/taxes

Get SAC tax information by code

Get mapped GST rates (CGST, SGST, IGST) and condition-based taxation guidelines for calculating services tax logic.

Parameter	Description
code Required	Exact numeric SAC code (starting with 99).

Sample Request

curl -X 'GET' \
  'https://api.taxlookup.fastgst.in/search/sac/998314/taxes' \
  -H 'accept: */*' \
  -H 'X-API-Key: FGST_TEST_************************'

Sample Response

{
  "success": true,
  "data": {
    "gst_rate": 18,
    "gst_breakdown": {
      "cgst": 9,
      "sgst": 9,
      "igst": 18
    },
    "conditions": "Standard rate for IT software services",
    "is_exempted": false,
    "exemption_status": "Taxable"
  },
  "meta": {
    "api_version": "v1",
    "timestamp": "2026-04-07",
    "request_id": "req_0HNKKS1B9IQEV:00000001"
  }
}

Standard Response Format

All API responses follow a unified JSON envelope schema containing top-level success, data (or error), and meta objects.

{
  "success": true,
  "data": { ... },
  "meta": {
    "apiVersion": "v1",
    "timestamp": "2024-03-01T12:00:00Z",
    "requestId": "req_84d3b..."
  }
}