What "Manage API access" on the GST portal is
A taxpayer can authorise a GST Suvidha Provider (GSP) or an application service provider (ASP) to act on their own account, for example to file returns or work with e-invoicing. The portal makes this a setting the taxpayer controls, and it is how the taxpayer allows software to reach their account.
The first part has been there for years: log in to the GST portal, open My Profile, choose Manage API access from the quick links, set Enable API Request to Yes, pick a duration and confirm. The duration can be as short as 6 hours or as long as 30 days, and during it the software does not need an OTP each time.
Since 2026 the same page carries a second part. Below the Yes/No setting there is a block called "Select Duration, GSP-ASP combination" where the taxpayer names which GSP and which ASP may use the access, and a "GSP/ASP Access History Table" that lists what was selected. The portal’s own note on that page says that from 30/09/2026 only the combinations listed in that table are permitted API access to the GSTIN. The next section walks through it.
Sources: GST portal, My Profile > Manage API Access (logged-in page, as shown on 24 Oct 2026) · GSTN advisory, 29 Sep 2025: transparency of data access via GSP/ASP (PDF) · ClearTax: all you need to know about GST API access
How to enable API access today: Yes, duration, then the GSP-ASP combination
These are the steps as the GST portal shows them in October 2026. Do them while logged in as the GSTIN you want to connect; each GSTIN has its own Manage API Access page, so a business with several registrations repeats this under each login.
- Log in at gst.gov.in, open My Profile and choose Manage API Access from the quick links.
- Set Enable API Request to Yes, pick a duration and click Confirm. This is the old step and it is still required.
- On the same page, under "Select Duration, GSP-ASP combination", open the GSP dropdown and pick the GSP, open the ASP dropdown and pick the ASP, choose a duration and click Select.
- The pair you chose now appears as a row in the GSP/ASP Access History Table. The portal allows up to 5 combinations per GSTIN; the table is empty until you add one.
- Go back to the software that will use the access and complete its OTP connection. On gstinapi.in that is the GSTR-2B & GST Return Filing page of the dashboard: enter the GSTIN and its GST portal username, then the OTP the portal sends to the registered mobile or email.
Selecting a combination grants nothing by itself. The portal’s notes under the table say so: API access is enabled only when the taxpayer provides a valid OTP so that the GSP/ASP can create an AUTH session, the session stays active for the chosen duration, and after that a new OTP is needed. Setting Enable API Request back to No stops new sessions; deleting a combination stops that GSP/ASP from requesting OTPs. The same page has View logs, Revoke active token and View revoked token links, so you can see and cut off every session that was created.
How strictly the table is enforced is not clear yet, as far as we know. The portal’s note states the rule, and that is reason enough to select the combination before you connect. At the same time, as of 25 Oct 2026 we have seen GSTINs with an empty table fetch GSTR-2A without any error, weeks after the 30/09/2026 date in the note. So a missing combination is one thing to check when a call is refused, not the only one; the section on errors below has the other known cause.
Sources: GST portal, My Profile > Manage API Access (logged-in page, as shown on 24 Oct 2026)
What to select for gstinapi.in
gstinapi.in reaches the GST network through a licensed GSP, and the portal needs its registered name in both dropdowns. Pick exactly these: as far as we know, a pair for a different GSP or ASP does not cover calls made through this site.
| Dropdown | What to pick |
|---|---|
| GSP | BVM IT Consulting Services India Pvt Ltd |
| ASP | BVM IT Consulting Services India Pvt Ltd |
| Duration | Your choice. 30 days is the longest the portal offers and means the fewest repeats. The connection on gstinapi.in is renewed with its own OTP, so this is a ceiling on how long a session may live, not a promise of 30 days without an OTP. |
Do this once per GSTIN, under that GSTIN’s own GST portal login. Then connect the GSTIN on the GSTR-2B & GST Return Filing page of the gstinapi.in dashboard with a fresh OTP. If the GSTIN was already connected before you added the combination, disconnect it there and connect it again, so that the new session is created under the selected pair.
This applies to everything on gstinapi.in that acts on your own GSTIN: fetching GSTR-2A tables, fetching or generating GSTR-2B, and saving or filing GSTR-1 and GSTR-3B. It does not apply to verifying other businesses’ GSTINs, which needs only your API key.
What it does not do
It gives software access to your own registration. It is not a switch that lets you query any other GSTIN. To check a supplier or a customer you look them up, and the portal’s own way to do that is the public Search Taxpayer page, a form where a person types the 15-digit GSTIN and a captcha.
As far as we know there is no public, key-free API for looking up other taxpayers. Software gets that data through a GSP, which is the arrangement gstinapi.in is built on: you send one HTTP request with an API key, and the GSP infrastructure does the rest.
Which one do you need
| You want to | What you need |
|---|---|
| Check whether a supplier or customer’s GSTIN is real and active | A GSTIN verification API. Nothing to enable on the GST portal. |
| Check whether that vendor files its returns | A verification API that also returns filing history, such as the returns endpoint here. |
| File your own returns from accounting software | Manage API access on your own GST account, plus the software or GSP you file through. |
| Generate e-way bills or e-invoices from your own system | API access set up for your GSTIN, plus an API that files them. See the e-way bill API page. |
| Look up one GSTIN by hand | The GST portal’s Search Taxpayer page, or the free GST number search on this site. |
If you see an "API access" error
An error about API access, or one that asks for an OTP again, usually means the taxpayer’s API access is switched off or the authorised session has run out. Re-enable it under My Profile, Manage API access, pick a duration and complete the OTP. If the error appears while you are only trying to verify someone else’s GSTIN, the tool you are using is asking for your own account’s access when it should not need it, and a verification API sidesteps that.
RET11402 "API Authorization Failed" on a GSTR-2A call from gstinapi.in, right after the OTP connection succeeded, has two known causes, as far as we know. One is the GSP-ASP combination: the portal’s note says that only listed combinations are permitted API access, so if the GSP/ASP Access History Table is empty, or lists another pair but not the one above, add the combination for gstinapi.in, then disconnect and reconnect the GSTIN with a fresh OTP. That said, as of 25 Oct 2026 we have also seen GSTINs with an empty table work, so a missing combination is not the only cause. The other is a GST portal username that belongs to a different GSTIN’s login: a username can only reach the GSTIN shown on its own portal dashboard, so log in with it, read the GSTIN there, and reconnect with the right username. The portal’s "View logs" link under Manage API Access shows whether our authentication sessions reached this GSTIN at all, which tells the two apart. GSTR-2B and GSTR-1 answer the same two mistakes with their own codes (RET2B1013 and RET01203); the fix is the same, and the API’s error response carries it as a "fix" field. None of these failed calls are charged.
Frequently asked questions
How do I enable API access on the GST portal?
Log in, open My Profile, choose Manage API access from the quick links, set Enable API Request to Yes, choose a duration and confirm. Then, on the same page under "Select Duration, GSP-ASP combination", pick the GSP, the ASP and a duration and click Select, so the pair appears in the GSP/ASP Access History Table. The portal’s note says that from 30/09/2026 only listed combinations are permitted API access. Finally complete the OTP connection in the software you use; selecting alone grants nothing.
Which GSP and ASP do I select for gstinapi.in?
GSP: BVM IT Consulting Services India Pvt Ltd. ASP: BVM IT Consulting Services India Pvt Ltd. Pick any duration (30 days is the longest), click Select, then connect the GSTIN on the gstinapi.in dashboard with a fresh OTP. If it was connected before you added the pair, disconnect and reconnect it.
Do I need GST portal API access to use gstinapi.in?
Not for verifying other businesses’ GSTINs: you sign up, copy your API key and send one header, and nothing is enabled on the GST portal. You do need it for anything that acts on your own GSTIN through gstinapi.in, such as GSTR-2A, GSTR-2B and GSTR-1/3B, and the portal’s Manage API Access page now also asks for the GSP-ASP combination described above.
What does RET11402 "API Authorization Failed" mean?
The GST network refused a GSTR-2A call for the connected GSTIN. Two known causes, as far as we know: the GSP-ASP combination for gstinapi.in is not selected on the GST portal (the portal’s note says only listed combinations are permitted, though we have also seen GSTINs work without it), or the GST portal username you connected with belongs to a different GSTIN’s login. Add the combination under that GSTIN’s own login, check the GSTIN shown on the dashboard of the login you used, then disconnect and reconnect the GSTIN with a fresh OTP. The portal’s View logs link under Manage API Access shows whether our sessions reached this GSTIN. Failed calls are not charged.
Can I look up any GSTIN with GST portal API access?
No. Manage API access authorises software to act on your own account. Looking up another taxpayer is done through the public Search Taxpayer page, or through a verification API.
Is the GST portal’s search page free?
Yes, for a person searching by hand: you enter the GSTIN and a captcha. It is a web form, so it does not suit checking a whole vendor list. For that, use bulk verification or an API.
Do e-way bill and e-invoice APIs need API access?
The GSTIN needs e-way bill / e-invoice API access set up before anything can be filed for it. That is separate from your gstinapi.in key. The e-way bill API page explains the prerequisite.
Start with up to 75 free lookups
10 on signup and 65 more across three setup steps. No card, and they never expire.
Create a free account