# India GSTIN Format Validation API

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

Validates a GSTIN (Goods and Services Tax Identification Number) by checking its format, extracting the embedded state code, PAN, and entity type, and verifying the Luhn-mod-36 checksum.

## Facts

- Endpoint: GET https://verifyapi.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-gstin-format-validation-api-33b51fb1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_mkDOuyvmR-dx_68naP9P1

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-gstin-format-validation-api-33b51fb1
```

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

## When to prefer this

Use this endpoint when you need to validate an Indian GSTIN number for format correctness, extract the embedded state and PAN holder type, or perform pre-invoice GST compliance checks without needing live government database lookup. Ideal for lightweight, pay-per-call format validation at $0.005 USDC.

## Known failure modes

- Invalid or malformed GSTIN returns valid=false
- GSTIN with incorrect length or characters returns an error or invalid response
- Non-existent or unrecognized state code returns invalid
- Network/payment failure returns HTTP 402 if USDC payment not provided
- Rate limiting or server errors return 5xx responses

## How this service works

Pay-per-call India business and identity verification: IFSC, pincode, and GSTIN format validation. Powered by x402 — pay in USDC on Base.

## Output

Returns a JSON object with the input GSTIN, a boolean `valid` field, the decoded `state` name (e.g. Maharashtra), and `pan_holder_type` (e.g. Firm/LLP), confirming format correctness including the Luhn-mod-36 checksum.

## 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-gstin-format-validation-api-33b51fb1/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from verifyapi.hillguava.xyz](https://www.zero.xyz/host/verifyapi.hillguava.xyz/llms.txt)