IRN Detail API

This API is to get JSON for IRN

The IRN Detail API can be used to verify the authenticity and validity of the e-invoice, as well as to access related information such as the digital signature, the QR code, the e-Way Bill number, and the status of the e-invoice.

To use the IRN Detail API, the user needs to send an HTTP GET request to the URL of the API, along with the IRN as a parameter in the URL. The user also needs to provide the authentication details such as the GSTIN, and the auth token in the request header.

The API will return a JSON response that contains the status of the request, the data, the error details, and the info details. The data is a base64 encoded string of the decrypted invoice JSON using the SEK (Session Encryption Key). The error details and the info details are also base64 encoded strings that contain the error code, the error message, and any additional information.

Name
Description

Method Type

GET

Headers

Key
Value
Mandatory

Gstin

33AADCT1398N1ZI

Mandatory. Buyer Business GSTIN

Authorization

JWT paste token value

Yes

Params

Leave Blank

Action

Hit Send Button

Success Response

{
  "message": "Success",
  "data": {
    "_id": "654dc1421794b0c071a6447c",
    "docNum": "2023241706",
    "docDt": "01/11/2023",
    "docType": "INV",
    "supplyType": "B2B",
    "totInvAmt": 46614.72,
    "irn": "5ca9fe3a867878f811feb99fd43a754b2164ac9b6e3c51305d968c45703e12o1",
    "irnStatus": "ACT",
    "ackNo": "152316134408458",
    "ackDt": "2023-11-01 17:14:00",
    "ewbNo": "",
    "ewbDt": "",
    "cnldt": "",
    "invoice_type": "b2b",
    "f_year": "2023-24",
    "imonth": "11",
    "returnPeriod": "112023",
    "buyer_gstin": "33AADCT1398N1ZI",
    "supplier_gstin": "33ABSPV6417F1ZK",
    "docDt_ts": 1698777000,
    "ackDt_ts": 1698839040,
    "fetch_detail": 0,
    "created": "2023-11-10T05:34:38.213488",
    "modified": "2023-11-10T05:34:38.213491",
    "data": {
      "AckNo": 152316134408457,
      "AckDt": "2023-11-01 17:14:00",
      "Irn": "5ca9fe3a867878f811feb99fd43a754b2164ac9b6e3c51305d968c45703e12e1",
      "Version": "1.1",
      "TranDtls": {
        "TaxSch": "GST",
        "SupTyp": "B2B",
        "RegRev": "N",
        "IgstOnIntra": "N"
      },
      "DocDtls": {
        "Typ": "INV",
        "No": "2023241307",
        "Dt": "01/11/2023"
      },
      "SellerDtls": {
        "Gstin": "33ABSPV6417F1ZI",
        "LglNm": "VJAY DEVENGINEERING WORKS",
        "Addr1": "40, SIPCOT INDUSTRIAL COMPLEX, HOSUR",
        "Loc": "Hosur",
        "Pin": 635126,
        "Stcd": "33"
      },
      "BuyerDtls": {
        "Gstin": "33AADCT1398N1ZI",
        "LglNm": "KV INVESTMENTS OF INDIA LTD",
        "Pos": "33",
        "Addr1": "NO.50/16B, TVS ROAD, BEHIND BP PETROL BUNK, (NANDHINI SERVICE SATATION), KOTHAGONDAPALLI, ",
        "Addr2": "HOSUR-635109",
        "Loc": "HOSUR",
        "Pin": 635109,
        "Stcd": "33"
      },
      "ItemList": [
        {
          "ItemNo": 0,
          "SlNo": "1",
          "IsServc": "N",
          "PrdDesc": "SAC - 30.5X25.05X496",
          "HsnCd": "8408",
          "Qty": 4938,
          "FreeQty": 0,
          "Unit": "NOS",
          "UnitPrice": 8,
          "TotAmt": 39504,
          "Discount": 0,
          "AssAmt": 39504,
          "GstRt": 18,
          "IgstAmt": 0,
          "CgstAmt": 3555.36,
          "SgstAmt": 3555.36,
          "CesRt": 0,
          "CesAmt": 0,
          "CesNonAdvlAmt": 0,
          "TotItemVal": 46614.72
        }
      ],
      "ValDtls": {
        "AssVal": 39504,
        "CgstVal": 3555.36,
        "SgstVal": 3555.36,
        "IgstVal": 0,
        "CesVal": 0,
        "Discount": 0,
        "OthChrg": 0,
        "RndOffAmt": 0,
        "TotInvVal": 46614.72
      }
    },
    "SignedInvoice": "eyJhbGciOiJSUzI1NiIsImtpZCI6IkI4RDYzRUNCNThFQTVFNkY0QUFDM0Q1MjQ1NDNCMjI0NjY2OUIwRjgiLCJ4NXQiOiJ1TlkteTFqcVhtOUtyRDFTUlVPeUpHWnBzUGciLCJ0eXAiOiJKV1QifQ.eyJkYXRhIjoie1wiQWNrTm9cIjoxNTIzMTYxMzQ0MDg0NTcsXCJBY2tEdFwiOlwiMjAyMy0xMS0wMSAxNzoxNDowMFwiLFwiSXJuXCI6XCI1Y2E5ZmUzYTg2Nzg3OGY4MTFmZWI5OWZkNDNhNzU0YjIxNjRhYzliNmUzYzUxMzA1ZDk2OGM0NTcwM2UxMmUxXCIsXCJWZXJzaW9uXCI6XCIxLjFcIixcIlRyYW5EdGxzXCI6e1wiVGF4U2NoXCI6XCJHU1RcIixcIlN1cFR5cFwiOlwiQjJCXCIsXCJSZWdSZXZcIjpcIk5cIixcIklnc3RPbkludHJhXCI6XCJOXCJ9LFwiRG9jRHRsc1wiOntcIlR5cFwiOlwiSU5WXCIsXCJOb1wiOlwiMjAyMzI0MTMwNlwiLFwiRHRcIjpcIjAxLzExLzIwMjNcIn0sXCJTZWxsZXJEdGxzXCI6e1wiR3N0aW5cIjpcIjMzQUJTUFY2NDE3RjFaQVwiLFwiTGdsTm1cIjpcIkFKQVkgRU5HSU5FRVJJTkcgV09SS1NcIixcIkFkZHIxXCI6XCIxMzdBLCBTSVBDT1QgSU5EVVNUUklBTCBDT01QTEVYLCBIT1NVUlwiLFwiTG9jXCI6XCJIb3N1clwiLFwiUGluXCI6NjM1MTI2LFwiU3RjZFwiOlwiMzNcIn0sXCJCdXllckR0bHNcIjp7XCJHc3RpblwiOlwiMzNBQURDVDEzOThOMVpYXCIsXCJMZ2xObVwiOlwiVFVCRSBJTlZFU1RNRU5UUyBPRiBJTkRJQSBMVERcIixcIlBvc1wiOlwiMzNcIixcIkFkZHIxXCI6XCJOTy41MjkvMUIsIFRWUyBST0FELCBCRUhJTkQgQlAgUEVUUk9MIEJVTkssIChOQU5ESElOSSBTRVJWSUNFIFNBVEFUSU9OKSwgS09USEFHT05EQVBBTExJLCBcIixcIkFkZHIyXCI6XCJIT1NVUi02MzUxMDlcIixcIkxvY1wiOlwiSE9TVVJcIixcIlBpblwiOjYzNTEwOSxcIlN0Y2RcIjpcIjMzXCJ9LFwiSXRlbUxpc3RcIjpbe1wiSXRlbU5vXCI6MCxcIlNsTm9cIjpcIjFcIixcIklzU2VydmNcIjpcIk5cIixcIlByZERlc2NcIjpcIlNBQyAtIDMwLjVYMjUuMDVYNDk2XCIsXCJIc25DZFwiOlwiODQwOFwiLFwiUXR5XCI6NDkzOCxcIkZyZWVRdHlcIjowLFwiVW5pdFwiOlwiTk9TXCIsXCJVbml0UHJpY2VcIjo4LFwiVG90QW10XCI6Mzk1MDQsXCJEaXNjb3VudFwiOjAsXCJBc3NBbXRcIjozOTUwNCxcIkdzdFJ0XCI6MTgsXCJJZ3N0QW10XCI6MCxcIkNnc3RBbXRcIjozNTU1LjM2LFwiU2dzdEFtdFwiOjM1NTUuMzYsXCJDZXNSdFwiOjAsXCJDZXNBbXRcIjowLFwiQ2VzTm9uQWR2bEFtdFwiOjAsXCJUb3RJdGVtVmFsXCI6NDY2MTQuNzJ9XSxcIlZhbER0bHNcIjp7XCJBc3NWYWxcIjozOTUwNCxcIkNnc3RWYWxcIjozNTU1LjM2LFwiU2dzdFZhbFwiOjM1NTUuMzYsXCJJZ3N0VmFsXCI6MCxcIkNlc1ZhbFwiOjAsXCJEaXNjb3VudFwiOjAsXCJPdGhDaHJnXCI6MCxcIlJuZE9mZkFtdFwiOjAsXCJUb3RJbnZWYWxcIjo0NjYxNC43Mn19IiwiaXNzIjoiTklDIn0.ol_oKili54dCu8wuOXCo9Jru3xApJFb5OtjQ3OHBIQuRkRYtusLsNpNt0BWjW2wX2QRL37dzV3m3JVPokhoeMYhpGyOm3K0_G_UiaQkJ6Zd0f9j8HFPpOnPRixlRbzXH8y7qS523ToQHmx3N2zBdMcTNaVuyWfm_bEoIDMVViIggzrvM4m3RGt6Nxf_fTYKCf6B85HSRuWhpKWnren6S6wz2XDPUvUkM8zbS3CEudq_HQcMEf1FM9K8OZxgOu4Y-lQu0LOCq8WWLWxUW07avTfr2vZ60WovZxEHo9LPxRmgWSX8_2sKVrD1GeDBk51X0qYKjYJAIjwY4uTlQtlsjKQ",
    "SignedQRCode": "eyJhbGciOiJSUzI1NiIsImtpZCI6IkI4RDYzRUNCNThFQTVFNkY0QUFDM0Q1MjQ1NDNCMjI0NjY2OUIwRjgiLCJ4NXQiOiJ1TlkteTFqcVhtOUtyRDFTUlVPeUpHWnBzUGciLCJ0eXAiOiJKV1QifQ.eyJkYXRhIjoie1wiU2VsbGVyR3N0aW5cIjpcIjMzQUJTUFY2NDE3RjFaQVwiLFwiQnV5ZXJHc3RpblwiOlwiMzNBQURDVDEzOThOMVpYXCIsXCJEb2NOb1wiOlwiMjAyMzI0MTMwNlwiLFwiRG9jVHlwXCI6XCJJTlZcIixcIkRvY0R0XCI6XCIwMS8xMS8yMDIzXCIsXCJUb3RJbnZWYWxcIjo0NjYxNC43MixcIkl0ZW1DbnRcIjoxLFwiTWFpbkhzbkNvZGVcIjpcIjg0MDhcIixcIklyblwiOlwiNWNhOWZlM2E4Njc4NzhmODExZmViOTlmZDQzYTc1NGIyMTY0YWM5YjZlM2M1MTMwNWQ5NjhjNDU3MDNlMTJlMVwiLFwiSXJuRHRcIjpcIjIwMjMtMTEtMDEgMTc6MTQ6MDBcIn0iLCJpc3MiOiJOSUMifQ.MYJ64L9JNJ8yJc4XTl7Md-CBhadKYcOqIc0JSjlcCi3UKay0ckYvVcKay--LpTPHvPWhfKFQEGqza0QH_pfD_MlXSBKWR1Ad0CJ3vcSBSqtn3wrdKARaeTCB8fOy8zyKOtieUi7Rol03P4mxCWZdhlB0zWyohoNZ_7D7geWOFgnqw_U4qIsOoSKkkK5qGxdyMh628xxWZvOQmVdrKtInYAeGTWaFPmDwH-2DOLlLZS-kZ7PTefLQcBBltCvYyN_aeLhk41DRJRiLLHfAuDm_jOqkzZHbwnGwe6z_ztmrEObid_UnPwtPeAsRIR3jb1w5OR02GR1I6NI8xVG5-BL0bQ"
  },
  "success": true
}

Last updated