{
  "info": {
    "name": "gstinapi.in",
    "description": "GSTIN verification, PAN lookup, HSN/SAC, vendor monitoring, webhooks, e-way bill and e-invoice — the same endpoints and sample requests as https://www.gstinapi.in/docs and https://www.gstinapi.in/playground. Set the `apiKey` collection variable to your own key from https://www.gstinapi.in/api-keys before sending requests.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "variable": [
    { "key": "baseUrl", "value": "https://www.gstinapi.in" },
    { "key": "apiKey", "value": "YOUR_API_KEY_HERE" }
  ],
  "item": [
    {
      "name": "GSTIN",
      "item": [
        {
          "name": "Verify a GSTIN",
          "request": {
            "method": "GET",
            "header": [{ "key": "x-api-key", "value": "{{apiKey}}" }],
            "url": {
              "raw": "{{baseUrl}}/v1/gstin/:gstin?include=profile",
              "host": ["{{baseUrl}}"],
              "path": ["v1", "gstin", ":gstin"],
              "query": [{ "key": "include", "value": "profile" }],
              "variable": [{ "key": "gstin", "value": "00AAAAA0000A1ZT", "description": "Free test GSTIN, always answers in sandbox." }]
            }
          }
        },
        {
          "name": "Filing history (returns)",
          "request": {
            "method": "GET",
            "header": [{ "key": "x-api-key", "value": "{{apiKey}}" }],
            "url": {
              "raw": "{{baseUrl}}/v1/gstin/:gstin/returns?fy=2025-26",
              "host": ["{{baseUrl}}"],
              "path": ["v1", "gstin", ":gstin", "returns"],
              "query": [{ "key": "fy", "value": "2025-26" }],
              "variable": [{ "key": "gstin", "value": "33AAAAA0000A1Z5" }]
            }
          }
        },
        {
          "name": "Filing preference",
          "request": {
            "method": "GET",
            "header": [{ "key": "x-api-key", "value": "{{apiKey}}" }],
            "url": {
              "raw": "{{baseUrl}}/v1/gstin/:gstin/filing-preference?fy=2025-26",
              "host": ["{{baseUrl}}"],
              "path": ["v1", "gstin", ":gstin", "filing-preference"],
              "query": [{ "key": "fy", "value": "2025-26" }],
              "variable": [{ "key": "gstin", "value": "33AAAAA0000A1Z5" }]
            }
          }
        },
        {
          "name": "Compliance",
          "request": {
            "method": "GET",
            "header": [{ "key": "x-api-key", "value": "{{apiKey}}" }],
            "url": {
              "raw": "{{baseUrl}}/v1/gstin/:gstin/compliance?fy=2025-26",
              "host": ["{{baseUrl}}"],
              "path": ["v1", "gstin", ":gstin", "compliance"],
              "query": [{ "key": "fy", "value": "2025-26" }],
              "variable": [{ "key": "gstin", "value": "33AAAAA0000A1Z5" }]
            }
          }
        },
        {
          "name": "Account usage stats",
          "request": {
            "method": "GET",
            "header": [{ "key": "x-api-key", "value": "{{apiKey}}" }],
            "url": { "raw": "{{baseUrl}}/v1/gstin/stats/me", "host": ["{{baseUrl}}"], "path": ["v1", "gstin", "stats", "me"] }
          }
        }
      ]
    },
    {
      "name": "PAN",
      "item": [
        {
          "name": "PAN → GSTINs",
          "request": {
            "method": "GET",
            "header": [{ "key": "x-api-key", "value": "{{apiKey}}" }],
            "url": {
              "raw": "{{baseUrl}}/v1/pan/:pan/gstins",
              "host": ["{{baseUrl}}"],
              "path": ["v1", "pan", ":pan", "gstins"],
              "variable": [{ "key": "pan", "value": "AAPFU0939F" }]
            }
          }
        }
      ]
    },
    {
      "name": "HSN / SAC",
      "item": [
        {
          "name": "Look up an HSN code",
          "request": {
            "method": "GET",
            "header": [{ "key": "x-api-key", "value": "{{apiKey}}" }],
            "url": {
              "raw": "{{baseUrl}}/v1/hsn/:code",
              "host": ["{{baseUrl}}"],
              "path": ["v1", "hsn", ":code"],
              "variable": [{ "key": "code", "value": "01011010" }]
            }
          }
        },
        {
          "name": "Search HSN codes",
          "request": {
            "method": "GET",
            "header": [{ "key": "x-api-key", "value": "{{apiKey}}" }],
            "url": {
              "raw": "{{baseUrl}}/v1/hsn/search?q=cotton&kind=hsn&limit=20",
              "host": ["{{baseUrl}}"],
              "path": ["v1", "hsn", "search"],
              "query": [{ "key": "q", "value": "cotton" }, { "key": "kind", "value": "hsn" }, { "key": "limit", "value": "20" }]
            }
          }
        }
      ]
    },
    {
      "name": "Vendor monitoring",
      "item": [
        {
          "name": "Create a watchlist",
          "request": {
            "method": "POST",
            "header": [{ "key": "x-api-key", "value": "{{apiKey}}" }, { "key": "Content-Type", "value": "application/json" }],
            "body": { "mode": "raw", "raw": "{\n  \"name\": \"CA Firm Clients\",\n  \"frequency\": \"monthly\"\n}", "options": { "raw": { "language": "json" } } },
            "url": { "raw": "{{baseUrl}}/v1/watchlists", "host": ["{{baseUrl}}"], "path": ["v1", "watchlists"] }
          }
        },
        {
          "name": "Add an entry",
          "request": {
            "method": "POST",
            "header": [{ "key": "x-api-key", "value": "{{apiKey}}" }, { "key": "Content-Type", "value": "application/json" }],
            "body": { "mode": "raw", "raw": "[\n  { \"gstin\": \"27AAPFU0939F1ZV\", \"vendor_code\": \"V-1001\", \"label\": \"Sharma Traders\" }\n]", "options": { "raw": { "language": "json" } } },
            "url": {
              "raw": "{{baseUrl}}/v1/watchlists/:id/entries",
              "host": ["{{baseUrl}}"],
              "path": ["v1", "watchlists", ":id", "entries"],
              "variable": [{ "key": "id", "value": "12" }]
            }
          }
        },
        {
          "name": "Remove an entry",
          "request": {
            "method": "DELETE",
            "header": [{ "key": "x-api-key", "value": "{{apiKey}}" }],
            "url": {
              "raw": "{{baseUrl}}/v1/watchlists/:id/entries/:entryId",
              "host": ["{{baseUrl}}"],
              "path": ["v1", "watchlists", ":id", "entries", ":entryId"],
              "variable": [{ "key": "id", "value": "12" }, { "key": "entryId", "value": "58" }]
            }
          }
        },
        {
          "name": "List change events",
          "request": {
            "method": "GET",
            "header": [{ "key": "x-api-key", "value": "{{apiKey}}" }],
            "url": {
              "raw": "{{baseUrl}}/v1/watchlists/:id/events?severity=critical",
              "host": ["{{baseUrl}}"],
              "path": ["v1", "watchlists", ":id", "events"],
              "query": [{ "key": "severity", "value": "critical" }],
              "variable": [{ "key": "id", "value": "12" }]
            }
          }
        }
      ]
    },
    {
      "name": "Webhooks",
      "item": [
        {
          "name": "Register a webhook",
          "request": {
            "method": "POST",
            "header": [{ "key": "x-api-key", "value": "{{apiKey}}" }, { "key": "Content-Type", "value": "application/json" }],
            "body": { "mode": "raw", "raw": "{\n  \"url\": \"https://your-endpoint.example.com/gstin-changes\"\n}", "options": { "raw": { "language": "json" } } },
            "url": { "raw": "{{baseUrl}}/v1/webhooks", "host": ["{{baseUrl}}"], "path": ["v1", "webhooks"] }
          }
        }
      ]
    },
    {
      "name": "E-way bill",
      "item": [
        {
          "name": "Generate",
          "request": {
            "method": "POST",
            "header": [{ "key": "x-api-key", "value": "{{apiKey}}" }, { "key": "Content-Type", "value": "application/json" }],
            "body": { "mode": "raw", "raw": "{\n  \"gstin\": \"24AAAAA0000A1Z5\",\n  \"gstin_username\": \"your_ewb_api_username\",\n  \"password\": \"your_ewb_api_password\",\n  \"payload\": { \"supplyType\": \"O\", \"docType\": \"INV\", \"docNo\": \"INV-1001\" },\n  \"test_mode\": true\n}", "options": { "raw": { "language": "json" } } },
            "url": { "raw": "{{baseUrl}}/v1/ewaybill", "host": ["{{baseUrl}}"], "path": ["v1", "ewaybill"] }
          }
        },
        {
          "name": "Look up an existing one",
          "request": {
            "method": "POST",
            "header": [{ "key": "x-api-key", "value": "{{apiKey}}" }, { "key": "Content-Type", "value": "application/json" }],
            "body": { "mode": "raw", "raw": "{\n  \"gstin\": \"24AAAAA0000A1Z5\",\n  \"gstin_username\": \"your_ewb_api_username\",\n  \"password\": \"your_ewb_api_password\",\n  \"doc_type\": \"INV\",\n  \"doc_no\": \"INV-1001\",\n  \"test_mode\": true\n}", "options": { "raw": { "language": "json" } } },
            "url": { "raw": "{{baseUrl}}/v1/ewaybill/lookup", "host": ["{{baseUrl}}"], "path": ["v1", "ewaybill", "lookup"] }
          }
        },
        {
          "name": "Update vehicle",
          "request": {
            "method": "POST",
            "header": [{ "key": "x-api-key", "value": "{{apiKey}}" }, { "key": "Content-Type", "value": "application/json" }],
            "body": { "mode": "raw", "raw": "{\n  \"gstin\": \"24AAAAA0000A1Z5\",\n  \"gstin_username\": \"your_ewb_api_username\",\n  \"password\": \"your_ewb_api_password\",\n  \"ewaybill_no\": \"351000000123\",\n  \"vehicle_no\": \"GJ05CD5678\",\n  \"from_place\": \"SURAT\",\n  \"from_state\": 24,\n  \"reason_code\": \"4\",\n  \"reason_remark\": \"Vehicle changed\",\n  \"test_mode\": true\n}", "options": { "raw": { "language": "json" } } },
            "url": { "raw": "{{baseUrl}}/v1/ewaybill/update-vehicle", "host": ["{{baseUrl}}"], "path": ["v1", "ewaybill", "update-vehicle"] }
          }
        },
        {
          "name": "Update transporter",
          "request": {
            "method": "POST",
            "header": [{ "key": "x-api-key", "value": "{{apiKey}}" }, { "key": "Content-Type", "value": "application/json" }],
            "body": { "mode": "raw", "raw": "{\n  \"gstin\": \"24AAAAA0000A1Z5\",\n  \"gstin_username\": \"your_ewb_api_username\",\n  \"password\": \"your_ewb_api_password\",\n  \"ewaybill_no\": \"351000000123\",\n  \"transporter_id\": \"05AAABB0639G1Z8\",\n  \"test_mode\": true\n}", "options": { "raw": { "language": "json" } } },
            "url": { "raw": "{{baseUrl}}/v1/ewaybill/update-transporter", "host": ["{{baseUrl}}"], "path": ["v1", "ewaybill", "update-transporter"] }
          }
        },
        {
          "name": "Extend validity",
          "request": {
            "method": "POST",
            "header": [{ "key": "x-api-key", "value": "{{apiKey}}" }, { "key": "Content-Type", "value": "application/json" }],
            "body": { "mode": "raw", "raw": "{\n  \"gstin\": \"24AAAAA0000A1Z5\",\n  \"gstin_username\": \"your_ewb_api_username\",\n  \"password\": \"your_ewb_api_password\",\n  \"ewaybill_no\": \"351000000123\",\n  \"vehicle_no\": \"GJ05CD5678\",\n  \"from_place\": \"SURAT\",\n  \"from_state\": 24,\n  \"from_pincode\": 395001,\n  \"remaining_distance\": 120,\n  \"extension_reason_code\": 99,\n  \"extension_remark\": \"Delay in transit\",\n  \"consignment_status\": \"M\",\n  \"test_mode\": true\n}", "options": { "raw": { "language": "json" } } },
            "url": { "raw": "{{baseUrl}}/v1/ewaybill/extend-validity", "host": ["{{baseUrl}}"], "path": ["v1", "ewaybill", "extend-validity"] }
          }
        },
        {
          "name": "Details",
          "request": {
            "method": "POST",
            "header": [{ "key": "x-api-key", "value": "{{apiKey}}" }, { "key": "Content-Type", "value": "application/json" }],
            "body": { "mode": "raw", "raw": "{\n  \"gstin\": \"24AAAAA0000A1Z5\",\n  \"gstin_username\": \"your_ewb_api_username\",\n  \"password\": \"your_ewb_api_password\",\n  \"ewaybill_no\": \"351000000123\",\n  \"test_mode\": true\n}", "options": { "raw": { "language": "json" } } },
            "url": { "raw": "{{baseUrl}}/v1/ewaybill/details", "host": ["{{baseUrl}}"], "path": ["v1", "ewaybill", "details"] }
          }
        },
        {
          "name": "Reject",
          "request": {
            "method": "POST",
            "header": [{ "key": "x-api-key", "value": "{{apiKey}}" }, { "key": "Content-Type", "value": "application/json" }],
            "body": { "mode": "raw", "raw": "{\n  \"gstin\": \"24AAAAA0000A1Z5\",\n  \"gstin_username\": \"your_ewb_api_username\",\n  \"password\": \"your_ewb_api_password\",\n  \"ewaybill_no\": \"351000000123\",\n  \"test_mode\": true\n}", "options": { "raw": { "language": "json" } } },
            "url": { "raw": "{{baseUrl}}/v1/ewaybill/reject", "host": ["{{baseUrl}}"], "path": ["v1", "ewaybill", "reject"] }
          }
        },
        {
          "name": "Cancel",
          "request": {
            "method": "POST",
            "header": [{ "key": "x-api-key", "value": "{{apiKey}}" }, { "key": "Content-Type", "value": "application/json" }],
            "body": { "mode": "raw", "raw": "{\n  \"gstin\": \"24AAAAA0000A1Z5\",\n  \"gstin_username\": \"your_ewb_api_username\",\n  \"password\": \"your_ewb_api_password\",\n  \"ewaybill_no\": \"351000000123\",\n  \"cancel_reason_code\": \"1\",\n  \"cancel_remark\": \"wrong buyer\",\n  \"test_mode\": true\n}", "options": { "raw": { "language": "json" } } },
            "url": { "raw": "{{baseUrl}}/v1/ewaybill/cancel", "host": ["{{baseUrl}}"], "path": ["v1", "ewaybill", "cancel"] }
          }
        },
        {
          "name": "Close",
          "request": {
            "method": "POST",
            "header": [{ "key": "x-api-key", "value": "{{apiKey}}" }, { "key": "Content-Type", "value": "application/json" }],
            "body": { "mode": "raw", "raw": "{\n  \"gstin\": \"24AAAAA0000A1Z5\",\n  \"gstin_username\": \"your_ewb_api_username\",\n  \"password\": \"your_ewb_api_password\",\n  \"ewaybill_no\": \"351000000123\",\n  \"closure_date\": \"13/09/2026\",\n  \"remarks\": \"Goods delivered\",\n  \"test_mode\": true\n}", "options": { "raw": { "language": "json" } } },
            "url": { "raw": "{{baseUrl}}/v1/ewaybill/close", "host": ["{{baseUrl}}"], "path": ["v1", "ewaybill", "close"] }
          }
        }
      ]
    },
    {
      "name": "E-invoice",
      "item": [
        {
          "name": "Generate",
          "request": {
            "method": "POST",
            "header": [{ "key": "x-api-key", "value": "{{apiKey}}" }, { "key": "Content-Type", "value": "application/json" }],
            "body": { "mode": "raw", "raw": "{\n  \"gstin\": \"24AAAAA0000A1Z5\",\n  \"einv_username\": \"your_einv_api_username\",\n  \"password\": \"your_einv_api_password\",\n  \"payload\": { \"docDtls\": { \"no\": \"INV-1001\" } },\n  \"test_mode\": true\n}", "options": { "raw": { "language": "json" } } },
            "url": { "raw": "{{baseUrl}}/v1/einvoice", "host": ["{{baseUrl}}"], "path": ["v1", "einvoice"] }
          }
        },
        {
          "name": "Cancel",
          "request": {
            "method": "POST",
            "header": [{ "key": "x-api-key", "value": "{{apiKey}}" }, { "key": "Content-Type", "value": "application/json" }],
            "body": { "mode": "raw", "raw": "{\n  \"gstin\": \"24AAAAA0000A1Z5\",\n  \"einv_username\": \"your_einv_api_username\",\n  \"password\": \"your_einv_api_password\",\n  \"irn\": \"35a1b2c3...\",\n  \"cancel_reason\": \"1\",\n  \"cancel_remark\": \"wrong buyer\",\n  \"test_mode\": true\n}", "options": { "raw": { "language": "json" } } },
            "url": { "raw": "{{baseUrl}}/v1/einvoice/cancel", "host": ["{{baseUrl}}"], "path": ["v1", "einvoice", "cancel"] }
          }
        }
      ]
    }
  ]
}