Masters India APIs
Product DocWebsite
  • APIs documentation.
  • Environment
  • Auth API
  • SIM Tracking API
    • Add Driver
    • Driver Consent
    • Driver Location
    • Bulk Driver Location
    • Delete Driver
  • Proof of Delivery (POD) API
    • Introduction
    • Driver License API
    • Fastag API
    • Fastag API 02
    • Vehicle e-Challan
    • Vahan API - Vehicle Detail API (RC)
  • Invoice OCR API
    • Introduction
    • OCR Tax Invoice API
    • OCR QR Code API
    • OCR Delivery Order API
    • OCR BOE API
  • Vendor Verification API
    • MCA Status API
  • IRN APIs
    • Auth API
    • IRN List API
    • IRN Detail API
Powered by GitBook
On this page

Was this helpful?

  1. IRN APIs

IRN Detail API

This API is to get JSON for IRN

PreviousIRN List API

Last updated 10 months ago

Was this helpful?

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

URL

Pass the IRN Number In the API

Method Type

GET

Headers

Key
Value
Mandatory

Params

Leave Blank

Action

Hit Send Button

Success Response

Gstin

33AADCT1398N1ZI

Mandatory. Buyer Business GSTIN

Authorization

JWT paste token value

Yes

{
  "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
}
https://api-platform.mastersindia.co/api/v2/saas-apis/irn/5ca9fe3a867878f811feb99fd43a754b2164ac9b6e3c51305d968c45703e12o1