Install Jentic One Beta

Connect the GSTIN Verification API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the GSTIN Verification API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fgstinapi.in%2Fgstinapi" | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fgstinapi.in%2Fgstinapi" | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with GSTIN Verification API.

Look up an Indian GSTIN for legal name, status, taxpayer type, and address

Verify a PAN and find every GSTIN registered under it

Check GST return filing status, frequency, and compliance

Generate, update, and cancel e-way bills, including consolidated trip sheets

Save and file GSTR-1 and GSTR-3B returns with an OTP

GET STARTED

Start building with GSTIN Verification API

Explore with Jentic One

View OpenAPI Document

Use Cases

Patterns agents use GSTIN Verification API for, with concrete tasks.

★ Agent-driven GSTIN verification

An AI agent can verify a counterparty before a transaction through the GSTIN Verification API by looking up the GSTIN's legal name, registration status, taxpayer type, and address, all sourced live from India's GSP network. A free test GSTIN returns a sample in the live response shape, so the flow can be rehearsed. Connected through Jentic, the agent calls only the lookup operations it needs.

Look up a GSTIN and return its legal name, registration status, and registered address

GST return filing

Businesses filing GST returns need a programmatic path to save, preview, and file. The GSTIN Verification API saves and previews GSTR-1 and GSTR-3B, requests the filing OTP, and files the return once the OTP is entered, and it can generate and cancel e-invoices. An agent can prepare a return and complete filing with the OTP step in the loop.

Save a GSTR-3B return, request the filing OTP, and file it once the OTP is supplied

E-way bill and vendor monitoring

Logistics and procurement teams generate e-way bills and keep an eye on vendor GST status. The API generates, updates, extends, and cancels e-way bills, including consolidated trip sheets, and watches vendor GSTINs for change events delivered by webhook. An agent can issue an e-way bill for a shipment and alert on a vendor's status change.

Generate an e-way bill for a shipment and add the counterparty's GSTIN to a watchlist for change events

Key Endpoints

48 endpoints — the gstin verification api looks up an indian gstin for its legal name, trade name, registration status, taxpayer type, and registered address, sourced live from india's official gsp network.

METHOD

PATH

DESCRIPTION

GET

/v1/gstin/{gstin}

Look up a GSTIN

GET

/v1/pan/{pan}/verify

Verify a PAN and get the registered name

GET

/v1/pan/{pan}/gstins

Find every GSTIN registered under a PAN

POST

/v1/ewaybill

Generate an e-way bill

POST

/v1/gstr3b/file

File GSTR-3B with the OTP

POST

/v1/einvoice

Generate an e-invoice

POST

/v1/watchlists

Create a watchlist of vendor GSTINs

GET

/v1/gstin/{gstin}

Look up a GSTIN

GET

/v1/pan/{pan}/verify

Verify a PAN and get the registered name

GET

/v1/pan/{pan}/gstins

Find every GSTIN registered under a PAN

POST

/v1/ewaybill

Generate an e-way bill

POST

/v1/gstr3b/file

File GSTR-3B with the OTP

POST

/v1/einvoice

Generate an e-invoice

POST

/v1/watchlists

Create a watchlist of vendor GSTINs

Why Jentic?

What agents get from Jentic-routed access to this vendor.

Setup

Wiring the GSTIN Verification API by hand means handling its x-api-key header, switching to a Bearer JWT for watchlist routes, and sequencing the save, OTP, and file steps of a GST return yourself. Through Jentic you install once, import it from the API Directory, store the key once, and your agent calls it.

Permission scoping

The GSTIN Verification API carries the GSTIN, PAN, and return data in the path and body, so a rule bounds which operations your agent may call rather than which taxpayer. You choose the operations it may call, so return filing and e-way-bill generation are not included unless you add them.

Credential isolation

Your x-api-key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.

Intent-based discovery

Agents search Jentic by intent such as 'look up a GSTIN' or 'file a GST return', and Jentic returns the matching operation with its input schema so the agent calls the right endpoint without reading the reference docs.

FAQs

Specific to using GSTIN Verification API through Jentic.

What authentication does the GSTIN Verification API use?

The GSTIN Verification API authenticates with an x-api-key header on the GSTIN and filing endpoints, per its OpenAPI spec, and the watchlist routes additionally accept a Bearer JWT dashboard session token. Through Jentic the x-api-key is stored encrypted by your own Jentic One instance and injected at execution time, so it never enters the agent's context.

Can I verify a GSTIN and find GSTINs under a PAN with this API?

Yes. The GSTIN lookup returns the legal name, trade name, registration status, taxpayer type, and registered address, sourced live from India's GSP network. The PAN operations verify a PAN and return every GSTIN registered under it.

What are the rate limits for the GSTIN Verification API?

The OpenAPI spec does not publish fixed rate limits, and every account instead gets up to 75 free lookups that never expire before billed usage begins. Check https://www.gstinapi.in for current limits.

How do I verify a GSTIN with the GSTIN Verification API through Jentic?

Search Jentic for 'look up a GSTIN' and it returns the GSTIN lookup operation with its input schema, so your agent passes the GSTIN and calls it. Install Jentic One with `curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh`, import the GSTIN Verification API from the API Directory, and store your x-api-key once. To run it on your own infrastructure, install Jentic One from its GitHub repo.

Can I limit what my agent is allowed to do with the GSTIN Verification API?

Yes. Write a rule that allows only the GSTIN-lookup and PAN-verification operations, so the agent can verify counterparties but cannot file returns or generate e-way bills, and every call it makes is logged.

Is there a GSTIN Verification API MCP server?

You don't need an MCP server to connect your agent to the GSTIN Verification API. Jentic connects it directly from the API Directory: import it, store your credential once, and your agent discovers and calls the operations it needs on demand.

Gstinapi In GSTIN Verification API

AI ReadinessAI-Aware (B-)61/100

See full scorecard

Official vendor OpenAPI document · agent-readyFinanceTaxapiKey, bearer48 EndpointsREST

For Agents

Lets an AI agent verify Indian GSTINs and PANs, check GST filing status, generate e-way bills, and file GSTR-1 and GSTR-3B returns.

Use for: Look up an Indian GSTIN's legal name and status, Verify a PAN and get the holder's registered name, Find every GSTIN registered under a PAN, Generate an e-way bill for a shipment

Not supported: Does not handle income-tax filing, accounting ledgers, or payment collection. Use for GSTIN verification, GST returns, and e-way bills only.

The GSTIN Verification API looks up an Indian GSTIN for its legal name, trade name, registration status, taxpayer type, and registered address, sourced live from India's official GSP network. It also verifies PANs, finds every GSTIN under a PAN, reports return filing status and compliance, generates and manages e-way bills and e-invoices, and files GSTR-1 and GSTR-3B returns with an OTP. Vendor GSTINs can be watched for change events delivered by webhook.

Jentic One on Github View OpenAPI Document

Show dimension breakdown

Foundational Compliance

Base layer of spec validity and structural soundness.

Grade: D+Signals: 4

91%

Lint Results

Aggregated quality score from linter diagnostics, weighted by severity.

100%

Resolution Completeness

Percentage of `$ref` references that resolve successfully.

Specification Validity

Checks whether the API description parses successfully and conforms to its declared specification (e.g., OpenAPI).

Structural Integrity

Structural correctness score based on schema issues using logarithmic dampening.

Developer Experience & Jentic Compatibility

Clarity, completeness, and ingestion readiness for developers and tooling.

Grade: A-Signals: 4

15%

Example Density

How richly the API is illustrated with examples.

100%

Example Validity

Percentage of examples that conform to their schemas.

66%

Response Coverage

Percentage of operations with complete response definitions (success, client error, server error).

100%

Tooling Readiness

Health of API ingestion, bundling, and resolution within Jentic pipelines.

AI-Readiness & Agent Experience

Semantic breadth, depth, and agent comprehension for AI systems.

Grade: D+Signals: 4

40%

Description Coverage

Coverage of descriptions across API elements.

Error Standardization

Coverage of RFC 9457 Problem Details for error responses.

100%

OperationId Quality

Coverage, uniqueness, and casing consistency of operationIds for AI inference.

53%

Summary Coverage

Coverage of summaries across operations/tags/info.

Agent Usability

Functional utility, complexity comfort, and AI orchestration readiness.

Grade: A+Signals: 1

94%

Complexity Comfort

Agent comfort level based on API operational and structural complexity.

Security

Trust, risk posture, and security compliance.

Grade: B-Signals: 1

62%

Authentication Strength

Average quality of security schemes based on authentication method strength (weakest link for OAuth2).

AI Discoverability

Findability, semantic richness, and reasoning readiness.

Grade: A-Signals: 1

76%

Descriptive Richness

Clarity and depth of descriptions across API elements.

Connect the GSTIN Verification API to your agent

Capabilities

Start building with GSTIN Verification API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs

Gstinapi In GSTIN Verification API

Jentic AI Readiness Score

gstinapi.in — GSTIN Verification API

Foundational Compliance

Lint Results

Resolution Completeness

Specification Validity

Structural Integrity

Developer Experience & Jentic Compatibility

Example Density

Example Validity

Response Coverage

Tooling Readiness

AI-Readiness & Agent Experience

Description Coverage

Error Standardization

OperationId Quality

Summary Coverage

Agent Usability

Complexity Comfort

Security

Authentication Strength

AI Discoverability

Descriptive Richness