> For the complete documentation index, see [llms.txt](https://docs.cleartax.in/cleartax-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cleartax.in/cleartax-docs/e-invoicing-api/e-invoicing-api-reference/cleartax-e-invoicing-apis-xml-schema/b2b-e-invoicing-apis/get-e-invoice-by-irn.md).

# 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 Method

GET

### Request URL

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

### Request Headers

<table><thead><tr><th width="238">PARAMETER</th><th width="192">PARAM TYPE</th><th width="150">TYPE</th><th>DESCRIPTION</th></tr></thead><tbody><tr><td>X-Cleartax-Auth-Token</td><td>Header</td><td>String</td><td>Mandatory. The auth token generated from ClearTax user id and password. <a href="https://docs.cleartax.in/cleartax-for-developers/e-invoicing-api/e-invoicing-api-reference/authentication-token">Know how.</a></td></tr><tr><td>gstin</td><td>Header</td><td>String</td><td>Mandatory. GSTIN number for the user</td></tr></tbody></table>

### Request Path Params

There are no path parameters for this API.

### Request Query Params

<table><thead><tr><th width="150">KEY</th><th width="185.69472182596292">PARAM TYPE</th><th width="150">TYPE</th><th>DESCRIPTION</th></tr></thead><tbody><tr><td>irn</td><td>Query</td><td>String</td><td>Mandatory. IRN number. Multiple allowed</td></tr></tbody></table>

### Request Body

There is no request body for this API.

### Response Status Codes

| HTTP Status Code | Description                                                                  |
| ---------------- | ---------------------------------------------------------------------------- |
| 200              | For a successfully processed request (may be a success or validation error). |
| 401              | If the user is not authenticated for the operation.                          |
| 403              | If the user is not authorized for the operation.                             |
| 500              | If there are any unhandled exceptions on the Clear side.                     |

### Response Schema

| Parameter        | Data Type | Field Validations                                               | Description                           |
| ---------------- | --------- | --------------------------------------------------------------- | ------------------------------------- |
| document\_status | Status    | <p>Enum: IRN\_GENERATED, NOT\_CREATED,</p><p>IRN\_CANCELLED</p> | Status of the IRN                     |
| govt\_response   | Object    | NA                                                              | Response containing EInvoice details. |

#### Govt. Response Object

| Parameter     | Data Type | Field Validations | Description                          |
| ------------- | --------- | ----------------- | ------------------------------------ |
| Success       | Boolean   | ‘Y’, ‘N’          | If Success or Failure.               |
| AckNo         | Number    | NA                | Acknowledgement Number               |
| AckDt         | String    | NA                | Acknowledgement Date                 |
| IRN           | String    | 64 Digits         | Invoice Reference Number             |
| SignedInvoice | String    | NA                | Signed Invoice                       |
| SignedQRCode  | String    | NA                | QR code in JWT String.               |
| Status        | String    | <p><br>NA</p>     | <p><br>Status of the Invoice</p>     |
| EwbNo         | Number    | NA                | E-Way bill Number.                   |
| EwbDt         | String    | NA                | E-Way bill generation date and time. |
| EwbValidTill  | String    | NA                | E-Way bill expiry date and time.     |

### Sample Request & Response&#x20;

#### Request Body

There is no request body for this API.

#### Response - **Success:**&#x20;

**HTTP Status Code: 200 OK**

{% tabs %}
{% tab title="JSON Response - Success" %}

```json
[
    {
        "custom_fields": null,
        "deleted": false,
        "document_status": "IRN_GENERATED",
        "error_response": null,
        "errors": null,
        "govt_response": {
            "Success": "Y",
            "AckNo": 112310186022618,
            "AckDt": "2023-10-18 12:23:00",
            "Irn": "833aad2dba44d53d118f79eb8f5018c6ecf1419c83bef79214ba217253e22639",
            "SignedInvoice": "eyJhbGciOiJSUzI1NiIsImtpZCI6IjE1MTNCODIxRUU0NkM3NDlBNjNCODZFMzE4QkY3MTEwOTkyODdEMUYiLCJ4NXQiOiJGUk80SWU1R3gwbW1PNGJqR0w5eEVKa29mUjgiLCJ0eXAiOiJKV1QifQ.eyJkYXRhIjoie1wiQWNrTm9cIjoxMTIzMTAxODYwMjI2MTgsXCJBY2tEdFwiOlwiMjAyMy0xMC0xOCAxMjoyMzowMFwiLFwiSXJuXCI6XCI4MzNhYWQyZGJhNDRkNTNkMTE4Zjc5ZWI4ZjUwMThjNmVjZjE0MTljODNiZWY3OTIxNGJhMjE3MjUzZTIyNjM5XCIsXCJWZXJzaW9uXCI6XCIxLjFcIixcIlRyYW5EdGxzXCI6e1wiVGF4U2NoXCI6XCJHU1RcIixcIlN1cFR5cFwiOlwiQjJCXCIsXCJSZWdSZXZcIjpcIllcIixcIklnc3RPbkludHJhXCI6XCJOXCJ9LFwiRG9jRHRsc1wiOntcIlR5cFwiOlwiSU5WXCIsXCJOb1wiOlwiV0FSQjJCNjhcIixcIkR0XCI6XCIxMC8xMC8yMDIzXCJ9LFwiU2VsbGVyRHRsc1wiOntcIkdzdGluXCI6XCIyOUFBRkNENTg2MlIwMDBcIixcIkxnbE5tXCI6XCJOSUMgQ29tcGFueSBQdnQgTHRkXCIsXCJUcmRObVwiOlwiTklDIEluZHVzdHJpZXNcIixcIkFkZHIxXCI6XCI1dGggYmxvY2ssIGt1dmVtcHUgbGF5b3V0XCIsXCJBZGRyMlwiOlwia3V2ZW1wdSBsYXlvdXRcIixcIkxvY1wiOlwiR0FOREhJTkFHQVJcIixcIlBpblwiOjU2MDAzNyxcIlN0Y2RcIjpcIjI5XCIsXCJQaFwiOlwiOTAwMDAwMFwiLFwiRW1cIjpcImFiY0BnbWFpbC5jb21cIn0sXCJCdXllckR0bHNcIjp7XCJHc3RpblwiOlwiMjlBV0dQVjcxMDdCMVoxXCIsXCJMZ2xObVwiOlwiWFlaIENvbXBhbnkgUHZ0IEx0ZFwiLFwiVHJkTm1cIjpcIlhZWiBJbmR1c3RyaWVzXCIsXCJQb3NcIjpcIjEyXCIsXCJBZGRyMVwiOlwiN3RoIGJsb2NrLCBrdXZlbXB1IGxheW91dFwiLFwiQWRkcjJcIjpcImt1dmVtcHUgbGF5b3V0XCIsXCJMb2NcIjpcIkdBTkRISU5BR0FSXCIsXCJQaW5cIjo1NjIxNjAsXCJQaFwiOlwiOTExMTExMTExMTFcIixcIkVtXCI6XCJ4eXpAeWFob28uY29tXCIsXCJTdGNkXCI6XCIyOVwifSxcIkRpc3BEdGxzXCI6e1wiTm1cIjpcIkFCQyBjb21wYW55IHB2dCBsdGRcIixcIkFkZHIxXCI6XCI3dGggYmxvY2ssIGt1dmVtcHUgbGF5b3V0XCIsXCJBZGRyMlwiOlwia3V2ZW1wdSBsYXlvdXRcIixcIkxvY1wiOlwiQmFuYWdhbG9yZVwiLFwiUGluXCI6NTYyMTYwLFwiU3RjZFwiOlwiMjlcIn0sXCJTaGlwRHRsc1wiOntcIkdzdGluXCI6XCIyOUFXR1BWNzEwN0IxWjFcIixcIkxnbE5tXCI6XCJDQkUgY29tcGFueSBwdnQgbHRkXCIsXCJUcmRObVwiOlwia3V2ZW1wdSBsYXlvdXRcIixcIkFkZHIxXCI6XCI3dGggYmxvY2ssIGt1dmVtcHUgbGF5b3V0XCIsXCJBZGRyMlwiOlwia3V2ZW1wdSBsYXlvdXRcIixcIkxvY1wiOlwiQmFuYWdhbG9yZVwiLFwiUGluXCI6NTYyMTYwLFwiU3RjZFwiOlwiMjlcIn0sXCJJdGVtTGlzdFwiOlt7XCJJdGVtTm9cIjowLFwiU2xOb1wiOlwiMVwiLFwiSXNTZXJ2Y1wiOlwiTlwiLFwiUHJkRGVzY1wiOlwiUmljZVwiLFwiSHNuQ2RcIjpcIjcxMDY5MlwiLFwiQmFyY2RlXCI6XCIxMjM0NTZcIixcIlF0eVwiOjAuMixcIlVuaXRcIjpcIkJBR1wiLFwiVW5pdFByaWNlXCI6MTAwLjAsXCJUb3RBbXRcIjoyMC4wMCxcIkFzc0FtdFwiOjIwLjAwLFwiR3N0UnRcIjoxOC4wMDAsXCJJZ3N0QW10XCI6My42MCxcIkNnc3RBbXRcIjowLjAwLFwiU2dzdEFtdFwiOjAuMDAsXCJUb3RJdGVtVmFsXCI6MjMuNjB9XSxcIlZhbER0bHNcIjp7XCJBc3NWYWxcIjoyMC4wMCxcIkNnc3RWYWxcIjowLjAwLFwiU2dzdFZhbFwiOjAuMDAsXCJJZ3N0VmFsXCI6My42MCxcIlRvdEludlZhbFwiOjIzLjYwLFwiVG90SW52VmFsRmNcIjoxMjg5Ny43MH0sXCJFd2JEdGxzXCI6e1wiVHJhbnNJZFwiOlwiMTJBV0dQVjcxMDdCMVoxXCIsXCJUcmFuc05hbWVcIjpcIlhZWiBFWFBPUlRTXCIsXCJUcmFuc01vZGVcIjpcIjFcIixcIkRpc3RhbmNlXCI6MTAwLFwiVmVoTm9cIjpcImthMTIzNDU2XCIsXCJWZWhUeXBlXCI6XCJSXCJ9fSIsImlzcyI6Ik5JQyBTYW5kYm94In0.xun-87FXuJ0JbPzdotkr87JpIQ-XdsGeF7Iud4N6mEognC-st_DXAq7tZ7QXuGEC-uq5cHHoNiMP8qMeCgkerqBzt81jObv7KHmoHQL9yBwl08omWOQbb0wvLfs-J9jqGlN5qYWELO3oFn2HhrYzEeFz5GxPH4c5oRPW34wdkICUxZh43SUOlHL9vZ8XzOuAosHKli3K23zi4czfQmJY1kaclHxLrOKmWQz04Gb30xdYhE2MZQXk64vX32IgV9NNJ-JRiV-bowKrNoO9CAxvUmPBaWlIPc2Ygvx45K3HOCyX_RWAqFDneY1xgjtVobX1TgQIZjwmaOjvfiwO09qiBw",
            "SignedQRCode": "eyJhbGciOiJSUzI1NiIsImtpZCI6IjE1MTNCODIxRUU0NkM3NDlBNjNCODZFMzE4QkY3MTEwOTkyODdEMUYiLCJ4NXQiOiJGUk80SWU1R3gwbW1PNGJqR0w5eEVKa29mUjgiLCJ0eXAiOiJKV1QifQ.eyJkYXRhIjoie1wiU2VsbGVyR3N0aW5cIjpcIjI5QUFGQ0Q1ODYyUjAwMFwiLFwiQnV5ZXJHc3RpblwiOlwiMjlBV0dQVjcxMDdCMVoxXCIsXCJEb2NOb1wiOlwiV0FSQjJCNjhcIixcIkRvY1R5cFwiOlwiSU5WXCIsXCJEb2NEdFwiOlwiMTAvMTAvMjAyM1wiLFwiVG90SW52VmFsXCI6MjMuNjAsXCJJdGVtQ250XCI6MSxcIk1haW5Ic25Db2RlXCI6XCI3MTA2OTJcIixcIklyblwiOlwiODMzYWFkMmRiYTQ0ZDUzZDExOGY3OWViOGY1MDE4YzZlY2YxNDE5YzgzYmVmNzkyMTRiYTIxNzI1M2UyMjYzOVwiLFwiSXJuRHRcIjpcIjIwMjMtMTAtMTggMTI6MjM6MDBcIn0iLCJpc3MiOiJOSUMgU2FuZGJveCJ9.mWfTFv5SRJishPErx7RgYVHmL4RytCjLeD20x4Pam-Iy1CIA5tNnS9_QhlvxLV8tRIF1Qd0uTRMHOamcOMC6uO4QwNdAaFNFyRepTL5lr80ik-w8NOsW4V-BjgKVyVNl4r_YzfomijfYZzYgNOfhm0GEpECD6xK2uR_r23GpHQ-qwOxwAQE0ciaZN_BKqXmqjXwrgoQeVKGm9XiqiFxydjNvged1i0Cy2PrNYMUufr4kyfHW9zaniWkURLivUPW13TQWzo6qE6nQ0Ta7Yk_lPGdG_k0O5tlHDxszoK8wtl36q4VGSd_-mvW5qkKVMp0R2Ch97gEAYbyzMW1tSR00UQ",
            "Status": "ACT",
            "EwbNo": 191010273815,
            "EwbDt": "2023-10-18 12:23:00",
            "EwbValidTill": "2023-10-19 23:59:00"
        },
        "group_id": null,
        "gstin": "29AAFCD5862R000",
        "is_deleted": false,
        "owner_id": null,
        "tag_identifier": null,
        "transaction": {
            "Version": "1.1",
            "Irn": "833aad2dba44d53d118f79eb8f5018c6ecf1419c83bef79214ba217253e22639",
            "TranDtls": {
                "TaxSch": "GST",
                "RegRev": "Y",
                "SupTyp": "B2B",
                "IgstOnIntra": "N"
            },
            "DocDtls": {
                "Typ": "INV",
                "No": "WARB2B68",
                "Dt": "10/10/2023"
            },
            "SellerDtls": {
                "Gstin": "29AAFCD5862R000",
                "LglNm": "NIC Company Pvt Ltd",
                "TrdNm": "NIC Industries",
                "Addr1": "5th block, kuvempu layout",
                "Addr2": "kuvempu layout",
                "Loc": "GANDHINAGAR",
                "Pin": 560037,
                "Stcd": "29",
                "Ph": "9000000",
                "Em": "abc@gmail.com"
            },
            "BuyerDtls": {
                "Gstin": "29AWGPV7107B1Z1",
                "LglNm": "XYZ Company Pvt Ltd",
                "TrdNm": "XYZ Industries",
                "Pos": "12",
                "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": "Rice",
                    "IsServc": "N",
                    "HsnCd": "710692",
                    "Barcde": "123456",
                    "Qty": 0.200,
                    "Unit": "BAG",
                    "UnitPrice": 100.000,
                    "TotAmt": 20.00,
                    "AssAmt": 20.00,
                    "GstRt": 18.00,
                    "IgstAmt": 3.60,
                    "CgstAmt": 0.00,
                    "SgstAmt": 0.00,
                    "TotItemVal": 23.60
                }
            ],
            "ValDtls": {
                "AssVal": 20.00,
                "CgstVal": 0.00,
                "SgstVal": 0.00,
                "IgstVal": 3.60,
                "TotInvVal": 23.60,
                "TotInvValFc": 12897.70
            },
            "EwbDtls": {
                "TransId": "12AWGPV7107B1Z1",
                "TransName": "XYZ EXPORTS",
                "TransMode": "1",
                "Distance": 100,
                "VehNo": "ka123456",
                "VehType": "R"
            }
        },
        "transaction_id": "29AAFCD5862R000_WARB2B68_INV_2023",
        "transaction_metadata": null
    }
]
```

{% endtab %}

{% tab title="JSON Response - Failure" %}

```json
[
    {
        "custom_fields": null,
        "deleted": false,
        "document_status": "IRN_GENERATION_FAILED",
        "error_response": null,
        "errors": null,
        "govt_response": {
            "Success": "N",
            "ErrorDetails": [
                {
                    "error_code": "2148",
                    "error_message": "Requested IRN data is not available",
                    "error_source": "GOVT"
                }
            ]
        },
        "group_id": null,
        "gstin": "29AAFCD5862R000",
        "is_deleted": false,
        "owner_id": "2e74ec05-e37b-4b75-a947-add6f67540b7",
        "tag_identifier": null,
        "transaction": null,
        "transaction_id": null,
        "transaction_metadata": null
    }
]
```

{% endtab %}

{% tab title="XML Response - Success" %}

```xml
<?xml version='1.0' encoding='UTF-8'?>
<eInvoiceTransactionDTOes>
    <invoice_details>
        <deleted>false</deleted>
        <document_status>IRN_GENERATED</document_status>
        <govt_response>
            <Success>Y</Success>
            <AckNo>32500000221</AckNo>
            <AckDt>2025-06-05 19:06:09</AckDt>
            <Irn>28ff039326b40dbd6295a48416f6061177af86ba1e9263e62b75b4e8a2e03db8</Irn>
            <SignedInvoice>eyJ4NXQiOiI0NDE2YjBhMWNjZjA0MjQ3Mzg0Mzk5YmQ4OGVjZGRkOWRjMzcxZTBkIiwia2lkIjoiRURDNTdERTEzNThCMzAwQkE5Rjc5MzQwQTY2OTY4MzFGM0M4NTA0NyIsInR5cGUiOiJqd3QiLCJhbGciOiJSUzUxMiJ9.eyJkYXRhIjoie1wiQWNrTm9cIjozMjUwMDAwMDIyMSxcIkFja0R0XCI6XCIyMDI1LTA2LTA1IDE5OjA2OjA5XCIsXCJWZXJzaW9uXCI6XCIxLjFcIixcIklyblwiOlwiMjhmZjAzOTMyNmI0MGRiZDYyOTVhNDg0MTZmNjA2MTE3N2FmODZiYTFlOTI2M2U2MmI3NWI0ZThhMmUwM2RiOFwiLFwiVHJhbkR0bHNcIjp7XCJUYXhTY2hcIjpcIkdTVFwiLFwiUmVnUmV2XCI6XCJOXCIsXCJTdXBUeXBcIjpcIkIyQlwiLFwiSWdzdE9uSW50cmFcIjpcIk5cIn0sXCJEb2NEdGxzXCI6e1wiVHlwXCI6XCJJTlZcIixcIk5vXCI6XCJKZXRDaGVtaWNhbHMyXCIsXCJEdFwiOlwiMDUvMDYvMjAyNVwifSxcIlNlbGxlckR0bHNcIjp7XCJzZWxsZXJTZXpcIjpmYWxzZSxcIkdzdGluXCI6XCIyOUFBRkNENTg2MlIwMDBcIixcIkxnbE5tXCI6XCJOSUMgQ29tcGFueSBQdnQgTHRkXCIsXCJUcmRObVwiOlwiTklDIEluZHVzdHJpZXNcIixcIkFkZHIxXCI6XCI1dGggYmxvY2ssIGt1dmVtcHUgbGF5b3V0XCIsXCJBZGRyMlwiOlwia3V2ZW1wdSBsYXlvdXRcIixcIkxvY1wiOlwiR0FOREhJTkFHQVJcIixcIlBpblwiOjU2MDAzNyxcIlN0Y2RcIjpcIjI5XCIsXCJQaFwiOlwiOTAwMDAwMDAwMFwiLFwiRW1cIjpcImFiY0BnbWFpbC5jb21cIn0sXCJCdXllckR0bHNcIjp7XCJHc3RpblwiOlwiMjlBV0dQVjcxMDdCMVoxXCIsXCJMZ2xObVwiOlwiWFlaIENvbXBhbnkgUHZ0IEx0ZFwiLFwiVHJkTm1cIjpcIlhZWiBJbmR1c3RyaWVzXCIsXCJQb3NcIjpcIjEyXCIsXCJBZGRyMVwiOlwiN3RoIGJsb2NrLCBrdXZlbXB1IGxheW91dFwiLFwiQWRkcjJcIjpcImt1dmVtcHUgbGF5b3V0XCIsXCJMb2NcIjpcIkdBTkRISU5BR0FSXCIsXCJQaW5cIjo1NjIxNjAsXCJTdGNkXCI6XCIyOVwiLFwiUGhcIjpcIjkxMTExMTExMTExXCIsXCJFbVwiOlwieHl6QHlhaG9vLmNvbVwifSxcIkRpc3BEdGxzXCI6bnVsbCxcIlNoaXBEdGxzXCI6bnVsbCxcIkl0ZW1MaXN0XCI6W3tcIlNsTm9cIjpcIjFcIixcIlByZERlc2NcIjpcIlJpY2VcIixcIklzU2VydmNcIjpcIk5cIixcIkhzbkNkXCI6XCIxMDAxOTkyMFwiLFwiQmFyY2RlXCI6XCIxMjM0NTZcIixcIlF0eVwiOjEwMC4zNDUsXCJGcmVlUXR5XCI6MTAuMCxcIlVuaXRcIjpcIkJBR1wiLFwiVW5pdFByaWNlXCI6OTkuNTQ1LFwiVG90QW10XCI6OTk4OC44NCxcIkRpc2NvdW50XCI6MTAuMDAsXCJQcmVUYXhWYWxcIjoxLjAwLFwiQXNzQW10XCI6OTk3OC44NCxcIkdzdFJ0XCI6MTIuMDAwLFwiSWdzdEFtdFwiOjExOTcuNDYsXCJDZ3N0QW10XCI6MC4wMCxcIlNnc3RBbXRcIjowLjAwLFwiQ2VzUnRcIjo1LjAwMCxcIkNlc0FtdFwiOjQ5OC45NCxcIkNlc05vbkFkdmxBbXRcIjoxMC4wMCxcIlN0YXRlQ2VzUnRcIjoxMi4wMDAsXCJTdGF0ZUNlc0FtdFwiOjExOTcuNDYsXCJTdGF0ZUNlc05vbkFkdmxBbXRcIjo1LjAwLFwiT3RoQ2hyZ1wiOjEwLjAwLFwiVG90SXRlbVZhbFwiOjEyODk3LjcwLFwiT3JkTGluZVJlZlwiOlwiMzI1NlwiLFwiT3JnQ250cnlcIjpcIkFHXCIsXCJQcmRTbE5vXCI6XCIxMjM0NVwiLFwiQmNoRHRsc1wiOntcIk5tXCI6XCIxMjM0NTZcIixcIkV4cER0XCI6XCIwMS8wOC8yMDIwXCIsXCJXckR0XCI6XCIwMS8wOS8yMDIwXCJ9LFwiQXR0cmliRHRsc1wiOlt7XCJObVwiOlwiUmljZVwiLFwiVmFsXCI6XCIxMDAwMFwifV19XSxcIlZhbER0bHNcIjp7XCJBc3NWYWxcIjo5OTc4Ljg0LFwiQ2dzdFZhbFwiOjAuMDAsXCJTZ3N0VmFsXCI6MC4wMCxcIklnc3RWYWxcIjoxMTk3LjQ2LFwiQ2VzVmFsXCI6NTA4Ljk0LFwiU3RDZXNWYWxcIjoxMjAyLjQ2LFwiRGlzY291bnRcIjoxMC4wMCxcIk90aENocmdcIjoyMC4wMCxcIlJuZE9mZkFtdFwiOjAuMzAsXCJUb3RJbnZWYWxcIjoxMjkwOC4wMCxcIlRvdEludlZhbEZjXCI6MTI4OTcuNzB9LFwiUGF5RHRsc1wiOntcIk5tXCI6XCJBQkNERVwiLFwiQWNjRGV0XCI6XCI1Njk3Mzg5NzEzMjEwXCIsXCJNb2RlXCI6XCJDYXNoXCIsXCJGaW5JbnNCclwiOlwiU0JJTjExMDAwXCIsXCJQYXlUZXJtXCI6XCIxMDBcIixcIlBheUluc3RyXCI6XCJHaWZ0XCIsXCJDclRyblwiOlwidGVzdFwiLFwiRGlyRHJcIjpcInRlc3RcIixcIkNyRGF5XCI6MTAwLFwiUGFpZEFtdFwiOjEwMDAwLjAwLFwiUGF5bXREdWVcIjo1MDAwLjAwfSxcIlJlZkR0bHNcIjp7XCJJbnZSbVwiOlwiVEVTVFwiLFwiRG9jUGVyZER0bHNcIjp7XCJJbnZTdER0XCI6XCIwMS8wOC8yMDIwXCIsXCJJbnZFbmREdFwiOlwiMDEvMDkvMjAyMFwifSxcIlByZWNEb2NEdGxzXCI6W3tcIkludk5vXCI6XCJET0MvMDAyXCIsXCJJbnZEdFwiOlwiMDEvMDgvMjAyMFwiLFwiT3RoUmVmTm9cIjpcIjEyMzQ1NlwifV0sXCJDb250ckR0bHNcIjpbe1wiUmVjQWR2UmVmclwiOlwiRG9jLzAwM1wiLFwiUmVjQWR2RHRcIjpcIjAxLzA4LzIwMjBcIixcIlRlbmRSZWZyXCI6XCJBYmMwMDFcIixcIkNvbnRyUmVmclwiOlwiQ28xMjNcIixcIkV4dFJlZnJcIjpcIllvNDU2XCIsXCJQcm9qUmVmclwiOlwiRG9jLTQ1NlwiLFwiUE9SZWZyXCI6XCJEb2MtNzg5XCIsXCJQT1JlZkR0XCI6XCIwMS8wOC8yMDIwXCJ9XX0sXCJBZGRsRG9jRHRsc1wiOlt7XCJub3RFbXB0eVwiOnRydWUsXCJVcmxcIjpcImh0dHBzOi8vZWludi1hcGlzYW5kYm94Lm5pYy5pblwiLFwiRG9jc1wiOlwiVGVzdCBEb2NcIixcIkluZm9cIjpcIkRvY3VtZW50IFRlc3RcIn1dLFwiRXhwRHRsc1wiOm51bGwsXCJFd2JEdGxzXCI6bnVsbH0iLCJpc3MiOiJDTEVBUiBJUlAifQ.SGSu-3MTQIzgcHMEkAsTM81STrrEDmAPHXmyKz7smDmiIMNXIyxtuyQ5s3CSCwSJlavV_pEIs9bD0FCcYgpUiSAqLIxHHQip_4Wi58AfbM6SmFjfMqbHG5G2w2UT8vXM5_xPWhiQ-lJ6ZxShCrcHgUPoZVQAHlkkstu_9Gizoczzwv4hlLnK_hBBJ-dRlsJnsyEmQpbbJszLQIbZWKo35Dekc6G91_Lko2zqx5es_VYtjdFFdNt81dinNGoxva8wCrhygfRErTXaL5wNQyjPeqVQnYRsBBFxCDGiUD8hUP54IWsNbpbj7AKn9bRFVLxoD2ai87busvkSEsHA5h4n5lZITqm6iR6YjTxtLeLYgEH_8Mtx6Dbm4c5IvOvTroFczgJ9b84YV6G9e39Plr2Ju4vaerSUwHjbxM4GohkKSDIdf2GT0OWCNtRDEVeHlLHanb2lyiqQ8AWy2qmSla2PF5BeuFbgiU_qvPnNhz1ljYM66Fl9BjJOYVyARS1jB3D1H4Ja-atXfCvkjOGswjkHCohjyxALVSHsvOpdDZ1vD0SK_e_mmpUpxxzfZNCubZAO54QeLNJ_UmUQopxBvK0fsOaAKKO-znWb76cRcs0S6PrZ8zGT5zgWB2IB6VqkxxyB2G4TxXWhgAIu7-1CchFWav-DWTiTLC5DlAz66w3f20s</SignedInvoice>
            <SignedQRCode>eyJ4NXQiOiI0NDE2YjBhMWNjZjA0MjQ3Mzg0Mzk5YmQ4OGVjZGRkOWRjMzcxZTBkIiwia2lkIjoiRURDNTdERTEzNThCMzAwQkE5Rjc5MzQwQTY2OTY4MzFGM0M4NTA0NyIsInR5cGUiOiJqd3QiLCJhbGciOiJSUzUxMiJ9.eyJkYXRhIjoie1wiU2VsbGVyR3N0aW5cIjpcIjI5QUFGQ0Q1ODYyUjAwMFwiLFwiQnV5ZXJHc3RpblwiOlwiMjlBV0dQVjcxMDdCMVoxXCIsXCJEb2NOb1wiOlwiSmV0Q2hlbWljYWxzMlwiLFwiRG9jVHlwXCI6XCJJTlZcIixcIkRvY0R0XCI6XCIwNS8wNi8yMDI1XCIsXCJUb3RJbnZWYWxcIjoxMjkwOC4wMCxcIkl0ZW1DbnRcIjoxLFwiTWFpbkhzbkNvZGVcIjpcIjEwMDE5OTIwXCIsXCJJcm5cIjpcIjI4ZmYwMzkzMjZiNDBkYmQ2Mjk1YTQ4NDE2ZjYwNjExNzdhZjg2YmExZTkyNjNlNjJiNzViNGU4YTJlMDNkYjhcIixcIklybkR0XCI6XCIyMDI1LTA2LTA1IDE5OjA2OjA5XCJ9IiwiaXNzIjoiQ0xFQVIgSVJQIn0.NYClEKsH0AGLSp1d09ppPMW-a0vx1yYO7OjwvrjMpGSY3SpZryBiE2tOrRKnF4svUIBra1KGwBzb9fxO477vgGJTYS4wUmymk5lWlCFXfBmT9PtvXrT1o38wQaVP-OSXcUkfNfg3UhWYyW1AIGanTJs5bTj3OD6MR7NueO7BTbHUjHngpQhQ3nODjnfTwoJRV826sDoOsEY7NcaqFWt3B4JpZJLfoNcX_RTbKaoD-ZlKB-gXjU59zg_giq-aN186-y4cRT_FLfIb1HSejCe8-kAJk_XEWI_pJzUBBFO9ClBCLfW5CPAqQ-PFADUeV7tBeEkqql2apB5vVLH0zgunxwYFBhXYDlUhdu7su_4RTesK-l6NcB2T2uNoYSSMDRuSS1a1I9WKsIg2lEmPDhYvoJyb_w0a82xWdifBNCtrbG8MxkFYdBlIgWQ1TU9L_HIDdP6L14Y2AmDfXXxHzLReA5wJjrF1jIJUYjVAqwUiB6EtTfhu510dCDs5wSI47UNNL5FHhDRPkp4WskYeL6CDSD-GbdNi5rYuvAefsfUKFBU7vLIfsehMlx-hS6whLrMH11j4N9colvW2-FNcnWvBShCVvpP8JZWDo0CyY00ifaxk3UjsBTMPHsVMhzadDk5VZzLu0adXmK8OMexjvM2_siLqMtKMDu11UJKW6XW9les</SignedQRCode>
            <Status>ACT</Status>
        </govt_response>
        <gstin>29AAFCD5862R000</gstin>
        <is_deleted>false</is_deleted>
        <transaction>
            <Version>1.1</Version>
            <Irn>28ff039326b40dbd6295a48416f6061177af86ba1e9263e62b75b4e8a2e03db8</Irn>
            <TranDtls>
                <TaxSch>GST</TaxSch>
                <RegRev>N</RegRev>
                <SupTyp>B2B</SupTyp>
                <IgstOnIntra>N</IgstOnIntra>
            </TranDtls>
            <DocDtls>
                <Typ>INV</Typ>
                <No>JetChemicals2</No>
                <Dt>05/06/2025</Dt>
            </DocDtls>
            <SellerDtls>
                <Gstin>29AAFCD5862R000</Gstin>
                <LglNm>NIC Company Pvt Ltd</LglNm>
                <TrdNm>NIC Industries</TrdNm>
                <Addr1>5th block, kuvempu layout</Addr1>
                <Addr2>kuvempu layout</Addr2>
                <Loc>GANDHINAGAR</Loc>
                <Pin>560037</Pin>
                <Stcd>29</Stcd>
                <Ph>9000000000</Ph>
                <Em>abc@gmail.com</Em>
            </SellerDtls>
            <BuyerDtls>
                <Gstin>29AWGPV7107B1Z1</Gstin>
                <LglNm>XYZ Company Pvt Ltd</LglNm>
                <TrdNm>XYZ Industries</TrdNm>
                <Pos>12</Pos>
                <Addr1>7th block, kuvempu layout</Addr1>
                <Addr2>kuvempu layout</Addr2>
                <Loc>GANDHINAGAR</Loc>
                <Pin>562160</Pin>
                <Stcd>29</Stcd>
                <Ph>91111111111</Ph>
                <Em>xyz@yahoo.com</Em>
            </BuyerDtls>
            <ItemList>
                <SlNo>1</SlNo>
                <PrdDesc>Rice</PrdDesc>
                <IsServc>N</IsServc>
                <HsnCd>10019920</HsnCd>
                <Barcde>123456</Barcde>
                <Qty>100.345</Qty>
                <FreeQty>10.000</FreeQty>
                <Unit>BAG</Unit>
                <UnitPrice>99.545</UnitPrice>
                <TotAmt>9988.84</TotAmt>
                <Discount>10.00</Discount>
                <PreTaxVal>1.00</PreTaxVal>
                <AssAmt>9978.84</AssAmt>
                <GstRt>12.00</GstRt>
                <IgstAmt>1197.46</IgstAmt>
                <CgstAmt>0.00</CgstAmt>
                <SgstAmt>0.00</SgstAmt>
                <CesRt>5.00</CesRt>
                <CesAmt>498.94</CesAmt>
                <CesNonAdvlAmt>10.00</CesNonAdvlAmt>
                <StateCesRt>12.00</StateCesRt>
                <StateCesAmt>1197.46</StateCesAmt>
                <StateCesNonAdvlAmt>5.00</StateCesNonAdvlAmt>
                <OthChrg>10.00</OthChrg>
                <TotItemVal>12897.70</TotItemVal>
                <OrdLineRef>3256</OrdLineRef>
                <OrgCntry>AG</OrgCntry>
                <PrdSlNo>12345</PrdSlNo>
                <BchDtls>
                    <Nm>123456</Nm>
                    <ExpDt>01/08/2020</ExpDt>
                    <WrDt>01/09/2020</WrDt>
                </BchDtls>
                <AttribDtls>
                    <Nm>Rice</Nm>
                    <Val>10000</Val>
                </AttribDtls>
            </ItemList>
            <ValDtls>
                <AssVal>9978.84</AssVal>
                <CgstVal>0.00</CgstVal>
                <SgstVal>0.00</SgstVal>
                <IgstVal>1197.46</IgstVal>
                <CesVal>508.94</CesVal>
                <StCesVal>1202.46</StCesVal>
                <Discount>10.00</Discount>
                <OthChrg>20.00</OthChrg>
                <RndOffAmt>0.30</RndOffAmt>
                <TotInvVal>12908.00</TotInvVal>
                <TotInvValFc>12897.70</TotInvValFc>
            </ValDtls>
            <PayDtls>
                <Nm>ABCDE</Nm>
                <AccDet>5697389713210</AccDet>
                <Mode>Cash</Mode>
                <FinInsBr>SBIN11000</FinInsBr>
                <PayTerm>100</PayTerm>
                <PayInstr>Gift</PayInstr>
                <CrTrn>test</CrTrn>
                <DirDr>test</DirDr>
                <CrDay>100</CrDay>
                <PaidAmt>10000.00</PaidAmt>
                <PaymtDue>5000.00</PaymtDue>
            </PayDtls>
            <RefDtls>
                <InvRm>TEST</InvRm>
                <DocPerdDtls>
                    <InvStDt>01/08/2020</InvStDt>
                    <InvEndDt>01/09/2020</InvEndDt>
                </DocPerdDtls>
                <PrecDocDtls>
                    <InvNo>DOC/002</InvNo>
                    <InvDt>01/08/2020</InvDt>
                    <OthRefNo>123456</OthRefNo>
                </PrecDocDtls>
                <ContrDtls>
                    <RecAdvRefr>Doc/003</RecAdvRefr>
                    <RecAdvDt>01/08/2020</RecAdvDt>
                    <TendRefr>Abc001</TendRefr>
                    <ContrRefr>Co123</ContrRefr>
                    <ExtRefr>Yo456</ExtRefr>
                    <ProjRefr>Doc-456</ProjRefr>
                    <PORefr>Doc-789</PORefr>
                    <PORefDt>01/08/2020</PORefDt>
                </ContrDtls>
            </RefDtls>
            <AddlDocDtls>
                <Url>https://einv-apisandbox.nic.in</Url>
                <Docs>Test Doc</Docs>
                <Info>Document Test</Info>
            </AddlDocDtls>
        </transaction>
        <transaction_id>29AAFCD5862R000_JetChemicals2_INV_2025</transaction_id>
    </invoice_details>
</eInvoiceTransactionDTOes>
```

{% endtab %}

{% tab title="XML Response - Failure" %}

```xml
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<eInvoiceTransactionDTOes>
    <invoice_details>
        <owner_id>2e74ec05-e37b-4b75-a947-add6f67540b7</owner_id>
        <gstin>29AAFCD5862R000</gstin>
        <document_status>IRN_GENERATION_FAILED</document_status>
        <govt_response>
            <Success>N</Success>
            <ErrorDetails>
                <error_code>2148</error_code>
                <error_message>Requested IRN data is not available</error_message>
                <error_source>GOVT</error_source>
            </ErrorDetails>
        </govt_response>
        <is_deleted>false</is_deleted>
    </invoice_details>
</eInvoiceTransactionDTOes>
```

{% endtab %}
{% endtabs %}

**Response - Failure**:&#x20;

**HTTP Status Code: 200 OK**

{% tabs %}
{% tab title="JSON" %}

```json
[
    {
        "custom_fields": null,
        "deleted": false,
        "document_status": "NOT_CREATED",
        "error_response": null,
        "errors": null,
        "govt_response": {
            "Success": "N",
            "ErrorDetails": [
                {
                    "error_code": "107",
                    "error_message": "null : Invalid IRN, it must be equal to 64 characters in length. Please send a valid value of IRN and try again.",
                    "error_source": "CLEARTAX"
                }
            ]
        },
        "group_id": null,
        "gstin": null,
        "is_deleted": false,
        "owner_id": null,
        "tag_identifier": null,
        "transaction": null,
        "transaction_id": null,
        "transaction_metadata": null
    }
]
```

{% endtab %}

{% tab title="XML" %}

```xml
<?xml version='1.0' encoding='UTF-8'?>
<eInvoiceTransactionDTOes>
    <invoice_details>
        <deleted>false</deleted>
        <document_status>NOT_CREATED</document_status>
        <govt_response>
            <Success>N</Success>
            <ErrorDetails>
                <error_code>107</error_code>
                <error_message>null : Invalid IRN, it must be equal to 64 characters in length. Please send a valid value of IRN and try again.</error_message>
                <error_source>CLEARTAX</error_source>
            </ErrorDetails>
        </govt_response>
        <is_deleted>false</is_deleted>
    </invoice_details>
</eInvoiceTransactionDTOes>
```

{% endtab %}
{% endtabs %}

### API Validations

Currently there are no known validations for this API.

### API Constraints

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