GSTIN API

Enable GSTIN, create a GST key or global key, and call the dedicated service from your server.

Make a request

curl 'https://gstapi.sandbee.in/api/v1/gstin/09AAFPC6958E1ZN' --header "Authorization: Bearer $SANDBEE_API_KEY"

Response contract

{
  "success": true,
  "data": {
    "gstin": "<queried GSTIN>",
    "legalName": "<business name>"
  },
  "meta": {
    "source": "database",
    "fetchedAt": "<ISO timestamp>",
    "elapsedMs": 0
  }
}

This is an illustrative envelope, not a live business result. Cached records retain their first-fetch timestamp and can become outdated.

Access and limits

• Use a gst:read key or a global key with GSTIN enabled.
• 60 authorized requests per minute per workspace, shared through MongoDB.
• Separate local IP limits and bounded queues also apply.
• Respect Retry-After on 429 responses. Keep retries bounded.
• Successful usage covers a rolling 90-day window.

Source failures

Handle invalid GSTINs, not-found results and temporary portal failures. CAPTCHA success is not guaranteed; a failure never becomes fabricated business data.