Get E-Invoice by IRN

You can get details of an invoice by sending a GET request to E-Invoicing API with the following request headers.

Request URL

GET {{HOST}}/einv/v2/eInvoice/get?irn={{IRN_number}}

A Maximum of 5 invoices can be fetched per API call.

Request Headers

PARAMETERPARAM TYPETYPEDESCRIPTION

X-Cleartax-Auth-Token

Header

String

Mandatory. The auth token generated from ClearTax user id and password. Know how.

gstin

Header

String

Mandatory. GSTIN number for the user

Query Parameters

KEYPARAM TYPETYPEDESCRIPTION

irn

Query

String

Mandatory. IRN number. Multiple allowed

Sample Response

[
    {
        "custom_fields": null,
        "deleted": false,
        "document_status": "IRN_GENERATED",
        "error_response": null,
        "errors": null,
        "govt_response": {
            "Success": "Y",
            "AckNo": 112310154573412,
            "AckDt": "2023-04-19 12:05:00",
            "Irn": "614bab69f1963f5d6ded1078a6cc0b21cb9a6e1606fe178a84ea1bd632275660",
            "SignedInvoice": "eyJhbGciOiJSUzI1NiIsImtpZCI6IjE1MTNCODIxRUU0NkM3NDlBNjNCODZFMzE4QkY3MTEwOTkyODdEMUYiLCJ0eXAiOiJKV1QiLCJ4NXQiOiJGUk80SWU1R3gwbW1PNGJqR0w5eEVKa29mUjgifQ.eyJkYXRhIjoie1wiQWNrTm9cIjoxMTIzMTAxNTQ1NzM0MTIsXCJBY2tEdFwiOlwiMjAyMy0wNC0xOSAxMjowNTowMFwiLFwiSXJuXCI6XCI2MTRiYWI2OWYxOTYzZjVkNmRlZDEwNzhhNmNjMGIyMWNiOWE2ZTE2MDZmZTE3OGE4NGVhMWJkNjMyMjc1NjYwXCIsXCJWZXJzaW9uXCI6XCIxLjFcIixcIlRyYW5EdGxzXCI6e1wiVGF4U2NoXCI6XCJHU1RcIixcIlN1cFR5cFwiOlwiQjJCXCIsXCJSZWdSZXZcIjpcIk5cIn0sXCJEb2NEdGxzXCI6e1wiVHlwXCI6XCJJTlZcIixcIk5vXCI6XCJOSUNBUEkxXCIsXCJEdFwiOlwiMDQvMDQvMjAyM1wifSxcIlNlbGxlckR0bHNcIjp7XCJHc3RpblwiOlwiMjlBQUZDRDU4NjJSMDAwXCIsXCJMZ2xObVwiOlwiTklDIGNvbXBhbnkgcHZ0IGx0ZFwiLFwiVHJkTm1cIjpcIk5JQyBJbmR1c3RyaWVzXCIsXCJBZGRyMVwiOlwiNXRoIGJsb2NrLCBrdXZlbXB1IGxheW91dFwiLFwiQWRkcjJcIjpcImt1dmVtcHUgbGF5b3V0XCIsXCJMb2NcIjpcIkdBTkRISU5BR0FSXCIsXCJQaW5cIjo1NjAwMzQsXCJTdGNkXCI6XCIyOVwiLFwiUGhcIjpcIjkwMDAwMDAwMDBcIixcIkVtXCI6XCJhYmNAZ21haWwuY29tXCJ9LFwiQnV5ZXJEdGxzXCI6e1wiR3N0aW5cIjpcIjI5QVdHUFY3MTA3QjFaMVwiLFwiTGdsTm1cIjpcIlhZWiBjb21wYW55IHB2dCBsdGRcIixcIlRyZE5tXCI6XCJYWVogSW5kdXN0cmllc1wiLFwiUG9zXCI6XCIyOVwiLFwiQWRkcjFcIjpcIjd0aCBibG9jaywga3V2ZW1wdSBsYXlvdXRcIixcIkFkZHIyXCI6XCJrdXZlbXB1IGxheW91dFwiLFwiTG9jXCI6XCJHQU5ESElOQUdBUlwiLFwiUGluXCI6NTYyMTYwLFwiUGhcIjpcIjkxMTExMTExMTExXCIsXCJFbVwiOlwieHl6QHlhaG9vLmNvbVwiLFwiU3RjZFwiOlwiMjlcIn0sXCJEaXNwRHRsc1wiOntcIk5tXCI6XCJBQkMgY29tcGFueSBwdnQgbHRkXCIsXCJBZGRyMVwiOlwiN3RoIGJsb2NrLCBrdXZlbXB1IGxheW91dFwiLFwiQWRkcjJcIjpcImt1dmVtcHUgbGF5b3V0XCIsXCJMb2NcIjpcIkJhbmFnYWxvcmVcIixcIlBpblwiOjU2MjE2MCxcIlN0Y2RcIjpcIjI5XCJ9LFwiU2hpcER0bHNcIjp7XCJHc3RpblwiOlwiMjlBV0dQVjcxMDdCMVoxXCIsXCJMZ2xObVwiOlwiQ0JFIGNvbXBhbnkgcHZ0IGx0ZFwiLFwiVHJkTm1cIjpcImt1dmVtcHUgbGF5b3V0XCIsXCJBZGRyMVwiOlwiN3RoIGJsb2NrLCBrdXZlbXB1IGxheW91dFwiLFwiQWRkcjJcIjpcImt1dmVtcHUgbGF5b3V0XCIsXCJMb2NcIjpcIkJhbmFnYWxvcmVcIixcIlBpblwiOjU2MjE2MCxcIlN0Y2RcIjpcIjI5XCJ9LFwiSXRlbUxpc3RcIjpbe1wiSXRlbU5vXCI6MCxcIlNsTm9cIjpcIjFcIixcIklzU2VydmNcIjpcIllcIixcIlByZERlc2NcIjpcIlNFUlZJQ0UgQ0hBUkdFUyhTTUFSVCBTVUlURVMpIFwiLFwiSHNuQ2RcIjpcIjk5NzIxMlwiLFwiUXR5XCI6MTAuMCxcIkZyZWVRdHlcIjoxLjAsXCJVbml0UHJpY2VcIjoxMDAuMCxcIlRvdEFtdFwiOjEwMDAuMDAsXCJEaXNjb3VudFwiOjAuMDAsXCJBc3NBbXRcIjoxMDAwLjAwLFwiR3N0UnRcIjoxOC4wMDAsXCJJZ3N0QW10XCI6MC4wMCxcIkNnc3RBbXRcIjo5MC4wMCxcIlNnc3RBbXRcIjo5MC4wMCxcIkNlc1J0XCI6MC4wMDAsXCJDZXNBbXRcIjowLjAwLFwiQ2VzTm9uQWR2bEFtdFwiOjAuMDAsXCJTdGF0ZUNlc1J0XCI6MC4wMDAsXCJTdGF0ZUNlc0FtdFwiOjAuMDAsXCJTdGF0ZUNlc05vbkFkdmxBbXRcIjowLjAwLFwiT3RoQ2hyZ1wiOjAuMDAsXCJUb3RJdGVtVmFsXCI6MTE4MC4wMH1dLFwiVmFsRHRsc1wiOntcIkFzc1ZhbFwiOjEwMDAuMDAsXCJDZ3N0VmFsXCI6OTAuMDAsXCJTZ3N0VmFsXCI6OTAuMDAsXCJJZ3N0VmFsXCI6MC4wMCxcIkNlc1ZhbFwiOjAuMDAsXCJTdENlc1ZhbFwiOjAuMDAsXCJEaXNjb3VudFwiOjAuMDAsXCJPdGhDaHJnXCI6MC4wMCxcIlJuZE9mZkFtdFwiOjAuMDAsXCJUb3RJbnZWYWxcIjoxMTgwLjAwfX0iLCJpc3MiOiJOSUMgU2FuZGJveCJ9.vuYRvsS_6NYzynw2NEe6q2hpwsoYOkhheH3KmPML7yfvcSNgCpIAWcjSfkoCqtDL2si7_SgGNqlF6YmZKZKKoP8kL3BfW0zSRDiYzlaKA1sPHPbdxk7Ir4_hzM8I7zv4g3Iu02SfRIdQR4HHHt7xMx7Ie6jNdQCTaqJ6k8eZE_yZHwFfLvZsn6WgwN5SYK6HLi3DLIButv8Hm4OZwlGUh8TyU6TFAw-jLeB8QnM1WUkI9WfL-soClUDwDe3RqstR2qEVamDftbVGz7O25u5Xy2lW0YoMgKvLjAuVc-MUAOdpj1WR07avdk-qggJ5TqNiy6PF_LuvZn7m8VKF6IkwuQ",
            "SignedQRCode": "eyJhbGciOiJSUzI1NiIsImtpZCI6IjE1MTNCODIxRUU0NkM3NDlBNjNCODZFMzE4QkY3MTEwOTkyODdEMUYiLCJ0eXAiOiJKV1QiLCJ4NXQiOiJGUk80SWU1R3gwbW1PNGJqR0w5eEVKa29mUjgifQ.eyJkYXRhIjoie1wiU2VsbGVyR3N0aW5cIjpcIjI5QUFGQ0Q1ODYyUjAwMFwiLFwiQnV5ZXJHc3RpblwiOlwiMjlBV0dQVjcxMDdCMVoxXCIsXCJEb2NOb1wiOlwiTklDQVBJMVwiLFwiRG9jVHlwXCI6XCJJTlZcIixcIkRvY0R0XCI6XCIwNC8wNC8yMDIzXCIsXCJUb3RJbnZWYWxcIjoxMTgwLjAwLFwiSXRlbUNudFwiOjEsXCJNYWluSHNuQ29kZVwiOlwiOTk3MjEyXCIsXCJJcm5cIjpcIjYxNGJhYjY5ZjE5NjNmNWQ2ZGVkMTA3OGE2Y2MwYjIxY2I5YTZlMTYwNmZlMTc4YTg0ZWExYmQ2MzIyNzU2NjBcIixcIklybkR0XCI6XCIyMDIzLTA0LTE5IDEyOjA1OjAwXCJ9IiwiaXNzIjoiTklDIFNhbmRib3gifQ.bgMgWt1yfQpgfUz02REEteqrMa9rh_jH9qrR5LP0ZoER01DuW8oCmwbCH4EENUmSznYclXQug3TpWXvAtAeCaJqMhMW_qcqo5ROof9AdkLKtaiiVw67B_dGlifQrZta-bGeiery7XCOgYM5SjwfsFkqgbdv9zf6uvJJcJalx6Cl0Ia7ry6lasFfAd-hpfdax4j4YyzE6m4-aSNGHgFaMKa7ZcOS23ploWObV76HNDeK6lU893TZMrYMNYtW5HayREs-UDhQ7qqyQa__G5Zp1Jf5WfFqtxpPkiIf-Aet9_hq1BXxf_NQ-3hc-vB3Co4j28revrNyWTz9fmjPtErZZ-g",
            "Status": "ACT"
        },
        "group_id": null,
        "gstin": "29AAFCD5862R000",
        "is_deleted": false,
        "owner_id": null,
        "tag_identifier": null,
        "transaction": {
            "Version": "1.1",
            "Irn": "614bab69f1963f5d6ded1078a6cc0b21cb9a6e1606fe178a84ea1bd632275660",
            "TranDtls": {
                "TaxSch": "GST",
                "RegRev": "N",
                "SupTyp": "B2B"
            },
            "DocDtls": {
                "Typ": "INV",
                "No": "NICAPI1",
                "Dt": "04/04/2023"
            },
            "SellerDtls": {
                "Gstin": "29AAFCD5862R000",
                "LglNm": "NIC company pvt ltd",
                "TrdNm": "NIC Industries",
                "Addr1": "5th block, kuvempu layout",
                "Addr2": "kuvempu layout",
                "Loc": "GANDHINAGAR",
                "Pin": 560034,
                "Stcd": "29",
                "Ph": "9000000000",
                "Em": "abc@gmail.com"
            },
            "BuyerDtls": {
                "Gstin": "29AWGPV7107B1Z1",
                "LglNm": "XYZ company pvt ltd",
                "TrdNm": "XYZ Industries",
                "Pos": "29",
                "Addr1": "7th block, kuvempu layout",
                "Addr2": "kuvempu layout",
                "Loc": "GANDHINAGAR",
                "Pin": 562160,
                "Stcd": "29",
                "Ph": "91111111111",
                "Em": "xyz@yahoo.com"
            },
            "DispDtls": {
                "Nm": "ABC company pvt ltd",
                "Addr1": "7th block, kuvempu layout",
                "Addr2": "kuvempu layout",
                "Loc": "Banagalore",
                "Pin": 562160,
                "Stcd": "29"
            },
            "ShipDtls": {
                "Gstin": "29AWGPV7107B1Z1",
                "LglNm": "CBE company pvt ltd",
                "TrdNm": "kuvempu layout",
                "Addr1": "7th block, kuvempu layout",
                "Addr2": "kuvempu layout",
                "Loc": "Banagalore",
                "Pin": 562160,
                "Stcd": "29"
            },
            "ItemList": [
                {
                    "SlNo": "1",
                    "PrdDesc": "SERVICE CHARGES(SMART SUITES) ",
                    "IsServc": "Y",
                    "HsnCd": "997212",
                    "Qty": 10.000,
                    "FreeQty": 1.000,
                    "UnitPrice": 100.000,
                    "TotAmt": 1000.00,
                    "Discount": 0.00,
                    "AssAmt": 1000.00,
                    "GstRt": 18.00,
                    "IgstAmt": 0.00,
                    "CgstAmt": 90.00,
                    "SgstAmt": 90.00,
                    "CesRt": 0.00,
                    "CesAmt": 0.00,
                    "CesNonAdvlAmt": 0.00,
                    "StateCesRt": 0.00,
                    "StateCesAmt": 0.00,
                    "StateCesNonAdvlAmt": 0.00,
                    "OthChrg": 0.00,
                    "TotItemVal": 1180.00
                }
            ],
            "ValDtls": {
                "AssVal": 1000.00,
                "CgstVal": 90.00,
                "SgstVal": 90.00,
                "IgstVal": 0.00,
                "CesVal": 0.00,
                "StCesVal": 0.00,
                "Discount": 0.00,
                "OthChrg": 0.00,
                "RndOffAmt": 0.00,
                "TotInvVal": 1180.00
            }
        },
        "transaction_id": "29AAFCD5862R000_NICAPI1_INV_2023",
        "transaction_metadata": null
    }
]

Last updated