> 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/rcm-self-invoicing-purchase-documents-clear-schema/get-invoice-details.md).

# Get Invoice Details

### Request Method

GET

### Request URL

```
{{host}}/einv/v1/einvoices/detail
```

There are two use cases here&#x20;

**Case 1:**&#x20;

By IRN: send only IRN

**Case 2:**&#x20;

By document details: documentNumber, documentType, documentDate, and sellerGstin stay mandatory as today (sellerGstin = URP for self-invoices). The new query parameter buyerGstin is mandatory when invoiceType = PURCHASE, because a purchase self-invoice is identified by Buyer GSTIN + Document Type + Document Number + Financial Year

### 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><tr><td>invoiceType</td><td>Header</td><td>String</td><td>PURCHASE or SALE</td></tr></tbody></table>

### Request Path Params

This API does not require any path parameters. All required inputs are sent via query parameters or headers.

### Request Query Params

<table><thead><tr><th>Parameter</th><th>Data Type</th><th width="213.166748046875">Field Validations( Case 1 By IRN )</th><th>Field Validations( Case 2 By Document details)</th></tr></thead><tbody><tr><td>irn</td><td>String</td><td>Mandatory</td><td>Not Required</td></tr><tr><td>documentNumber</td><td>String</td><td>Not Required</td><td>Mandatory</td></tr><tr><td>documentType</td><td>String</td><td>Not Required</td><td>Mandatory (INV, CRN, DBN)</td></tr><tr><td>documentDate</td><td>String</td><td>Not Required</td><td>Mandatory (dd/mm/yyyy)</td></tr><tr><td>sellerGstin</td><td>String</td><td>Not Required</td><td>Mandatory (URP for self-invoices)</td></tr><tr><td>buyerGstin (New)</td><td>String</td><td>Not Required</td><td>Mandatory when invoiceType = PURCHASE</td></tr><tr><td>invoiceType header (New)</td><td>String</td><td>PURCHASE for self - Invoices<br></td><td>PURCHASE for self-invoices </td></tr></tbody></table>

### Request Body

No request body is required for this API; all required parameters are passed as query parameters or headers.

#### Sample Request for Case 1

Get

```
{{HOST}}/einv/v1/einvoices/detail?irn=94b6c41efd740424c469908d0927db66d8f24d9dad78b02dab04ad1659813dc9
```

#### Sample Request for Case 2

Get

```
{{HOST}}/einv/v1/einvoices/detail?documentNumber=SI/2026/001&documentType=INV&documentDate=02/01/2027&sellerGstin=URP&buyerGstin=29AWGPV7107B1Z1
```

#### Sample Response:

```json
{
  "EinvoiceDetails": {
    "Version": "1.1",
    "Irn": "94b6c41efd740424c469908d0927db66d8f24d9dad78b02dab04ad1659813dc9",
    "TranDtls": { "TaxSch": "GST", "SupTyp": "RCMDOM", "RegRev": "Y", "IgstOnIntra": "N" },
    "DocDtls": { "Typ": "INV", "No": "SI/2026/001", "Dt": "02/01/2027" },
    "SellerDtls": { "Gstin": "URP", "LglNm": "ABC Traders", ... },
    "BuyerDtls": { "Gstin": "29AWGPV7107B1Z1", "LglNm": "XYZ Company Pvt Ltd", ... },
    "ItemList": [ ... ],
    "ValDtls": { ... }
  },
  "CustomFields": null,
  "GovtResponse": {
    "Success": "Y",
    "AckNo": 112310153714784,
    "AckDt": "2027-01-02 13:38:00",
    "Irn": "94b6c41efd740424c469908d0927db66d8f24d9dad78b02dab04ad1659813dc9",
    "SignedInvoice": "eyJhbGciOiJSUzI1NiIsImt......",
    "SignedQRCode": "eyJhbGciOiJSUzI1NiIsImt......",
    "Status": "ACT"
  },
  "InvoiceStatus": "GENERATED",
  "Gstin": "29AWGPV7107B1Z1",
  "Id": "6800bb0905ab13797131df3a"
}

```
