Skip to content
GET /v1/states

GST state-code reference

Try it live

10 free calls per day — no sign-up, no API key. Goes through the oanor gateway.

Custom headers (optional)
api.oanor.com/gst-api

It works. Grab an API key and use it in your project.

Get an API key

Code snippets

curl "https://api.oanor.com/gst-api/v1/states" \
  -H "x-oanor-key: oanor_test_..."
await fetch("https://api.oanor.com/gst-api/v1/states", {
  headers: { "x-oanor-key": "oanor_test_..." }
});
$ch = curl_init("https://api.oanor.com/gst-api/v1/states");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);
import requests
requests.get(
    "https://api.oanor.com/gst-api/v1/states",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

A real response from this endpoint, captured by the latest health check.

{
    "data": {
        "count": 40,
        "states": [
            {
                "code": "10",
                "name": "Bihar"
            },
            {
                "code": "11",
                "name": "Sikkim"
            },
            {
                "code": "12",
                "name": "Arunachal Pradesh"
            },
            {
                "code": "13",
                "name": "Nagaland"
            },
            {
                "code": "14",
                "name": "Manipur"
            },
            {
                "code": "15",
                "name": "Mizoram"
            },
            {
                "code": "16",
                "name": "Tripura"
            },
            {
                "code": "17",
                "name": "Meghalaya"
            },
            {
                "code": "18",
                "name": "Assam"
            },
            {
                "code": "19",
                "name": "West Bengal"
            },
            {
                "code": "20",
                "name": "Jharkhand"
            },
            {
                "code": "21",
                "name": "Odisha"
            },
            {
                "code": "22",
                "name": "Chhattisgarh"
            },
            {
                "code": "23",
                "name": "Madhya Pradesh"
            },
            {
                "code": "24",
                "name": "Gujarat"
            },
            {
                "code": "25",
                "name": "Daman and Diu"
            },
            {
                "code": "26",
                "name": "Dadra and Nagar Haveli"
            },
            {
                "code": "27",
                "name": "Maharashtra"
            },
            {
                "code": "28",
                "name": "Andhra Pradesh (Old)"
            },
            {
                "code": "29",
                "name": "Karnataka"
            },
            {
                "code": "30",
                "name": "Goa"
            },
            {
                "code": "31",
                "name": "Lakshadweep"
            },
            {
                "code": "32",
                "name": "Kerala"
            },
            {
                "code": "33",
                "name": "Tamil Nadu"
            },
            {
                "code": "34",
                "name": "Puducherry"
            },
            {
                "code": "35",
                "name": "Andaman and Nicobar Islands"
            },
            {
                "code": "36",
                "name": "Telangana"
            },
            {
                "code": "37",
                "name": "Andhra Pradesh (New)"
            },
            {
                "code": "38",
                "name": "Ladakh"
            },
            {
                "code": "97",
                "name": "Other Territory"
            },
            {
                "code": "99
…