# India Data Gateway — GSTIN Format Verifier

> India Data Gateway — GSTIN Format Verifier is a paid API for AI agents from gateway.hillguava.xyz, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-15).

Validates the format of a GSTIN (Goods and Services Tax Identification Number) and extracts state and PAN holder type from it

## Facts

- Endpoint: GET https://gateway.hillguava.xyz/verify/gstin-format/%7Bgstin%7D
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/india-data-gateway-gstin-format-verifier-1a81a342
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_GnqmzT9LvXi3Bzng-j7vs

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability india-data-gateway-gstin-format-verifier-1a81a342
```

Example prompt: Can you check if the GSTIN 27AAPFU0939F1ZV is correctly formatted and tell me which Indian state it belongs to and what type of entity it represents?

## When to prefer this

Use this endpoint when you need to quickly validate the structural format of an Indian GSTIN and extract encoded metadata (state, entity type) without needing a live registry lookup. Ideal for invoice validation pipelines, vendor onboarding, or compliance checks where no API key setup is desired and pay-per-call USDC pricing is acceptable.

## Known failure modes

- Invalid or malformed GSTIN string returns valid: false with no state or entity type
- Non-existent or random string may return invalid result
- GSTIN with incorrect checksum flagged as invalid
- Missing path parameter results in 404 or error response
- Payment failure via x402 results in 402 response before data is returned

## How this service works

The India data layer for AI agents. Pay only for the calls you make — no API keys, no accounts, no minimums, no rate limits. One x402 origin covering Indian weather (forecasts, monsoon), markets (stocks, indices, F&O with Black-Scholes Greeks, historical, mutual funds), RBI macro, identity/format verification (IFSC, pincode, GSTIN), NSE market holidays, panchang (Hindu almanac), and live cricket scores. Settle per call in USDC on Base.

## Output

A JSON object indicating whether the GSTIN is validly formatted (true/false), the Indian state it is registered in (e.g. Maharashtra), and the PAN holder type (e.g. Firm/LLP), along with the original GSTIN string.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "gstin": "27AAPFU0939F1ZV",
  "state": "Maharashtra",
  "valid": true,
  "pan_holder_type": "Firm/LLP"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/india-data-gateway-gstin-format-verifier-1a81a342/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from gateway.hillguava.xyz](https://www.zero.xyz/host/gateway.hillguava.xyz/llms.txt)