IRISGST - API Documentation (2024)

REST APIs for GST, Eway Bill and E-invoicing for taxpayers to integrate directly orvia system integrators.

IRIS is one of the leading compliance solution provider globally and in India.Selected as GSP in the very first round, IRIS GST has been associated with the GSTN ecosystem since itsinception and is aligned with India Stack APIs – a set of APIs that allows governments, businesses,startups and developers, to utilize a unique digital Infrastructure to solve India’s persistent problemsand move towards presence-less, paperless, and cashless service delivery.

IRIS Onyx for E-invoicing

IRIS Onyx is the solution for e-invoicing compliance in India. UsingIRIS Onyx taxpayer can get IRN generated, cancelled and all other operations supportedby the Invoice Registration Portal (IRP) of the Government

Know MoreAPIs

IRIS Topaz For Eway Bill

IRIS TOPAZ provides APIs to perform common EWB operations includingEWB generation, cancellation, updating of vehicle details (or PART B), rejection of EWBgenerated by others, consolidated EWB generation and others.

Know MoreAPIs

IRIS Sapphire APIs for GST compliance

IRIS Sapphire APIs cater to the needs of GST Compliance. These arevalue added API which can be used to interact with IRIS GST platform and Governmentsystem.

Know MoreAPIs

IRIS Peridot for GSTIN search

IRIS Peridot provides APIs for getting taxpayer details and its filinghistory on providing a GSTIN. These are common APIs provided by GST system and aresubject to caching policy.

Know MoreAPIs

IRIS Credixo for GST Data Analytics

IRIS Credixo is a platform to make available data and insights forspeedy and efficient digital lending. Using the IRIS Credixo APIs, lenders can getinformation about the borrowers with their consent, and define workflow using their owninterfaces.

Know MoreAPIs

IRIS IRP Passthrough for Einvoice

IRIS IRP is Government appointed invoice registry portal. For IRIS IRP APIs are available via IRIS GSP gateway for the solution providers

Know MoreAPIs

APIs for E-invoicing.

CategoryAPI NameAPI DescriptionShort URL
AuthenticationLoginLogin to IRIS Onyx. The token received in response to be used in all subsequentAPI requests. Token is valid for 24 hours or logout, whichever is earliermgmt/login
Core OnyxGenerate IRNSending single invoice data for IRN generationirn/addInvoice
Core OnyxCancel IRNCancel a generated IRN. Cancellation is allowed within 24 hours of generationirn/cancel
Upload InvoiceUpload FileUploading one or multiple invoices for a single GSTIN in a CSV file. The CSVfile will be the IRIS specified format/upload/invoices
Upload InvoiceUpload StatusCheck the status of uploaded file by providing upload ID/upload/status
Upload InvoiceUpload ErrorsGet details of errors during upload file/upload/errors
View InvoiceView ListTo get list of invoices based on the criteria selected and summary details forevery invoice/einvoice/view
View InvoiceView SummaryGet all the details of a single invoice on providing the IRIS invoice ID/einvoice/details
Entity ManagementGet GSTINsGet the list of GSTINs to which the user has been granted accessuser/company/filingbusiness

Onyx API Flow

Integration with Data APIs

IRISGST - API Documentation (2)

Integration for Upload Files

IRISGST - API Documentation (3)

Using IRIS Topaz

The taxpayers system can connect to the NIC system using the IRIS Topaz APIs. The following imagegives an high level view of the interaction between the parties involved i.e. taxpayers systems,IRIS Topaz and NIC systems

IRISGST - API Documentation (4)

IRISGST - API Documentation (5)

Using IRIS Peridot

IRIS Peridot is currently making available the common APIs of GST. These APIs do not require anyuser consent and can be accessed only via GSPs.

IRISGST - API Documentation (6)

More information on data available in these APIs

Taxpayer Search - https://irisgst.com/kb/search-taxpayer/

Return Status - https://irisgst.com/kb/taxpayer-return-status/

Using IRIS Credixo

In IRIS Credixo, any request for information is referred to as Order. There will be severaltypes of Orders. The Order Type covered in this document is GST Data.

IRIS Team will set-up the account for the lender and create the first Admin user. The Admin userwill need to complete the sign-up process. The Admin user can invite other users to access theaccount. User sign-up and management will be done through the web interface of IRIS Credixo.

High level Process Flow for IRIS Credixo API.

IRISGST - API Documentation (7)

Using IRIS Zircon

IRIS IRP is platform for invoice registration. IRIS IRP offers basic e-invoicing APIs and value-added APIs that extend beyond e-invoicing.

Solution providers can sign-up directly on IRIS IRP platform and get access to APIs. More info is available here

Option to get IRIS IRP APIs via IRIS GSP gateway (Zircon) is also available. Solution providers who operate from outside India and do not have Indian IP, can connect to IRIS IRP through GSP gateway. These are passthrough APIs and can be managed using your existing Zircon credentials

High level Integration process

IRISGST - API Documentation (8)

Using IRIS Sapphire

IRIS Sapphire APIs for GST compliance. Invoices and data from taxpayers systems can be sent toIRIS GST using APIs. Taxpayers will need to use the credentials set on IRIS system and businesshierarchy needs to be set-up on IRIS.For any upload of data to Government system or fetch of data from there (such as GSTR 2A), thesession with GST system via OTP process needs to be established.

Any form of reproduction, dissemination, copying, disclosure,modification, distribution and or publication of this material is strictly prohibited.

© 2020 IRIS Business Services Ltd. All Rights Reserved.

IRISGST - API Documentation (2024)
Top Articles
Latest Posts
Article information

Author: Otha Schamberger

Last Updated:

Views: 5703

Rating: 4.4 / 5 (55 voted)

Reviews: 94% of readers found this page helpful

Author information

Name: Otha Schamberger

Birthday: 1999-08-15

Address: Suite 490 606 Hammes Ferry, Carterhaven, IL 62290

Phone: +8557035444877

Job: Forward IT Agent

Hobby: Fishing, Flying, Jewelry making, Digital arts, Sand art, Parkour, tabletop games

Introduction: My name is Otha Schamberger, I am a vast, good, healthy, cheerful, energetic, gorgeous, magnificent person who loves writing and wants to share my knowledge and understanding with you.