Business · Live
IRN Lookup API
Fetch a registered e-invoice using its IRN.
What the IRN Lookup API does
Retrieve an e-invoice that has already been registered, using its IRN. Used to confirm a supplier’s invoice is genuinely registered before claiming input tax credit against it — a check that is far cheaper than discovering the problem at filing. Calls carry your own GST portal API credentials (GSTIN, username and password), so filings are made as you, on your own registration. We never file on our own account.
Popular use cases
- →Verifying a supplier invoice is registered before claiming input credit
- →Reconciling purchase records against the invoice registration portal
- →Audit and compliance tooling checking historic registrations
curl -X POST https://apisathi.in/gw/v1/einvoice-get-by-irn-v1/ \
-H "X-API-Key: live_xxx" \
-H "Content-Type: application/json" \
-d '{ "gstin": "23BEFPJ5660F2ZP", "username": "your_portal_user", "password": "•••", "query_string": "irn=a5c…" }'{
"success": true,
"data": { "Irn": "a5c…", "AckNo": 112010036356, "Status": "ACT" }
}Response fields returned by the IRN Lookup API
| Field | Example |
|---|---|
| success | true |
| data.Irn | a5c… |
| data.AckNo | 112010036356 |
| data.Status | ACT |
Every field, error code and the full schema are in the IRN Lookup API reference.
Call the IRN Lookup API from Node.js or Python
const res = await fetch('https://apisathi.in/gw/v1/einvoice-get-by-irn-v1/', {
method: 'POST',
headers: { 'X-API-Key': process.env.APISATHI_KEY, 'Content-Type': 'application/json' },
body: JSON.stringify({"gstin":"23BEFPJ5660F2ZP","username":"your_portal_user","password":"•••","query_string":"irn=a5c…"}),
});
const data = await res.json();import os, requests
res = requests.post(
"https://apisathi.in/gw/v1/einvoice-get-by-irn-v1/",
headers={"X-API-Key": os.environ["APISATHI_KEY"]},
json={"gstin":"23BEFPJ5660F2ZP","username":"your_portal_user","password":"•••","query_string":"irn=a5c…"},
timeout=30,
)
data = res.json()IRN Lookup API pricing
- → From ₹3 per successful call + 18% GST
- → Prepaid wallet from ₹200; no monthly fee, no minimum volume
- → Failed or timed-out calls are not charged
- → Bonus credit on recharges of ₹1,000 and above; GST invoice on every recharge
Start in four steps
- Create a free account — about a minute.
- Call the IRN Lookup API with your TEST key in the sandbox, free.
- Recharge the wallet (UPI, card or netbanking) from ₹200.
- Switch to your LIVE key — the same key works for every API.
Frequently asked questions
Why look up an IRN I did not create?
To confirm a supplier’s invoice is really registered. An unregistered invoice cannot support an input tax credit claim, and finding out at filing time is expensive.
Can I look up an invoice from its document number instead?
Yes — there is a separate endpoint that finds the IRN from document type, number and date.
How much does the IRN Lookup API cost?
The IRN Lookup API on API Sathi starts at ₹3 per successful call plus 18% GST, paid from a prepaid wallet. There is no monthly fee or minimum volume, and recharges of ₹1,000 or more earn bonus credit. Live prices for every API are on the pricing page.
Can I test the IRN Lookup API for free?
Yes. Every account gets a TEST key that calls the IRN Lookup API in the sandbox at no cost and returns realistic sample responses, so you can finish your integration before adding money to the wallet.
Am I charged if a IRN Lookup API call fails?
No. You pay only for successful calls. If the source is unavailable, times out or rejects the request, the amount held for that call is released straight back to your wallet.
How do I get a IRN Lookup API key?
Sign up at apisathi.in — it takes about a minute — and create a key under API Keys. Use the TEST key in the sandbox, then recharge from ₹200 and switch to a LIVE key. The same key works for every API on API Sathi.
Related APIs
Udyam Verification API
Confirm MSME status and pull the full Udyam record.
From ₹15/call
GST Verification API
Validate any GSTIN and fetch taxpayer details in one API call.
From ₹1.20/call
Company / CIN Verification API
Resolve companies, CINs, PANs and directors from the MCA graph.
From ₹3.60/call
E-Way Bill API
Generate an e-way bill for any consignment in a single API call.
From ₹3/call
E-Invoice API (IRN Generation)
Register an invoice and get its IRN, signed QR and acknowledgement.
From ₹3/call
E-Invoice Cancellation API
Cancel a registered IRN within the window the portal allows.
From ₹3/call
Start using the IRN Lookup API today
Sign up, recharge a prepaid wallet and generate a key in minutes. Lowest price guaranteed, no volume commitment.