Enterprises IRN single API

This API is to get list of IRNs

SIngle IRN API will allow users to get the list of (IRNs) and details or IRNs this can be used to retrieve the IRNs for a specific month or quarter, for Purchase Einvoices, and for a specific seller or buyer.

The API will return a JSON response that contains the Count and the data of IRN with details. The data JSON array that contains the IRNs and their details, such as the IRN, the invoice number, the invoice date, the invoice value, the status, the e-Way Bill number, and the e-Way Bill date.

Data from the government is available in T+1 day

IRN List + Detail API

Name	Description
URL	https://api-platform.mastersindia.co/api/v2/saas-apis/irn/?page=1&page_size=10&year=2023&month=8
Method Type	GET
Headers	Key Value Description Gstin 29AAICS6425J1O Mandatory. Buyer Business GSTIN Authorization JWT Paste token value
Params	Key Value Conditions page 1 non-mandatory. Default=1 page_size 10 non-mandatory. Default 2000. Maximum=2000 year 2023 Please either provide (month and year) or (ack_date_from and ack_date_to) if not given then by default month month 8 ack_date_from 2020-08-05 15:18:00 non-mandatory ack_date_to 2020-08-05 15:18:00 non-mandatory supplier_gstin 29AAICS6425J1ZB non-mandatory doc_date_from 2020-08-05 15:18:00 non-mandatory. only allow for 60 days difference between start date & end date doc_date_to 2020-08-05 15:18:00 non-mandatory
Action	Hit Send Button
Success Response	{ "message": "Data Found", "count": 1, "total_page": 1, "page_size": 10, "page": 1, "current_count": 1, "data": [ { "_id": "653b94c41e1c5f97cfec58bd", "docNum": "DD-20200804-9", "docDt": "04/08/2020", "docType": "INV", "supplyType": "B2B", "totInvAmt": 7776.3, "irn": "11f8ef701fe294d4a14aad0b12457e62775d0fdc41a0acf05b74fbb2ddc47acb", "irnStatus": "CNL", "ackNo": 112010000002315, "ackDt": "2020-08-05 15:18:00", "ewbNo": 191008688443, "ewbDt": "2020-08-05 15:18:00", "cnldt": "2020-08-06 14:34:27", "buyer_gstin": "29AAICS6425J1ZW", "supplier_gstin": "37ARZPT4384Q1MP", "data": { "AckNo": 112010000002315, "AckDt": "2020-08-05 15:18:00", "Irn": "11f8ef701fe294d4a14aad0b12457e62775d0fdc41a0acf05b74fbb2ddc47acb", "Version": "1.01", "TranDtls": { "TaxSch": "GST", "SupTyp": "B2B", "RegRev": "N", "IgstOnIntra": "Y" }, "DocDtls": { "Typ": "INV", "No": "DD-20200804-9", "Dt": "04/08/2020" }, "SellerDtls": { "Gstin": "37ARZPT4384Q1MT", "LglNm": " ABC company pvt ltd", "TrdNm": "vikas", "Addr1": "TE h", "Addr2": "abc", "Loc": "Bangalore", "Pin": 515311, "Stcd": "37", "Ph": "9738971970", "Em": "[e-mail]" }, "BuyerDtls": { "Gstin": "11AAACT3904F1ZZ", "LglNm": "XYZ company pvt ltd", "Pos": "37", "Addr1": "7th block, kuvempu layout", "Loc": "GANDHINAGAR", "Pin": 737101, "Stcd": "11" }, "DispDtls": { "Nm": "name of the company from which goods dispatched", "Addr1": "address", "Addr2": "Bangalore", "Loc": "kzk", "Pin": 690513, "Stcd": "32" }, "ShipDtls": { "Gstin": "32DIUPP1175G1Z1", "LglNm": "ship trade", "TrdNm": "vikas", "Addr1": "ship b no", "Addr2": "Bangalore", "Loc": "Bangalore", "Pin": 690513, "Stcd": "32" }, "ItemList": [ { "ItemNo": 1, "SlNo": "1", "IsServc": "N", "PrdDesc": "Steel", "HsnCd": "1001", "Qty": 10, "Unit": "BAG", "UnitPrice": 200, "TotAmt": 2000, "Discount": 10, "AssAmt": 1990, "GstRt": 12, "IgstAmt": 238.8, "CgstAmt": 0, "SgstAmt": 0, "CesRt": 5, "CesAmt": 99.5, "CesNonAdvlAmt": 10, "StateCesRt": 12, "StateCesAmt": 238.8, "StateCesNonAdvlAmt": 5, "OthChrg": 10, "TotItemVal": 2592.1 }, { "ItemNo": 2, "SlNo": "2", "IsServc": "N", "PrdDesc": "Steel", "HsnCd": "1001", "Qty": 10, "Unit": "BAG", "UnitPrice": 200, "TotAmt": 2000, "Discount": 10, "AssAmt": 1990, "GstRt": 12, "IgstAmt": 238.8, "CgstAmt": 0, "SgstAmt": 0, "CesRt": 5, "CesAmt": 99.5, "CesNonAdvlAmt": 10, "StateCesRt": 12, "StateCesAmt": 238.8, "StateCesNonAdvlAmt": 5, "OthChrg": 10, "TotItemVal": 2592.1 }, ], "ValDtls": { "AssVal": 5970, "CgstVal": 0, "SgstVal": 0, "IgstVal": 716.4, "CesVal": 328.5, "StCesVal": 731.4, "RndOffAmt": 0, "TotInvVal": 7776.3 }, "RefDtls": { "InvRm": "123", "PrecDocDtls": [ { "InvNo": "ABC", "InvDt": "02/02/2020", "OthRefNo": "12A" } ], "ContrDtls": [ { "RecAdvRefr": "123", "RecAdvDt": "12/02/2020", "TendRefr": "abc", "ContrRefr": "abc", "ExtRefr": "abc", "ProjRefr": "abc", "PORefr": "abc", "PORefDt": "12/02/2020" } ] }, "AddlDocDtls": [ { "Url": "https://einv-apisandbox.nic.in/gstcore_test/v1.01/invoice", "Docs": "vikas", "Info": "vikas" } ], "EwbDtls": { "TransId": "12AWGPV7107B1Z1", "TransName": "XYZ EXPORTS", "TransMode": "1", "Distance": 100, "TransDocNo": "DOC01", "TransDocDt": "04/08/2020", "VehNo": "ka123456", "VehType": "R" } } } ], "success": true

Data from the government is available in T+1 day

Response:

Key	Value	Description
count	2100	Total number of einvoices or records available in list API
total_page	2	Total number of pages.
page_size	2000	Required number of einvoice in single page.
page	1	current page
current_count	2000	Total number of einvoices present in current page.