> ## Documentation Index
> Fetch the complete documentation index at: https://developer.sandbox.co.in/llms.txt
> Use this file to discover all available pages before exploring further.
# Get e-Invoice by IRN
> Fetch the e-Invoice by passing the invoice registration number (IRN). To fetch an e-Invoice, the authenticated taxpayer has to be a party in the transaction, either the seller or the buyer.
#### Response body schema
Only e-Invoices within the last 6 months can be fetched.
## OpenAPI
````yaml api-reference/gst/compliance/openapi.json GET /gst/compliance/tax-payer/e-invoice/{irn}
openapi: 3.0.1
info:
title: compliance
description: >-
**GST Compliance API** enables businesses to automate compliance
requirements like [Taxpayer
verification](https://developer.sandbox.co.in/reference/search-gstin-api),
[GSTR
Filing](https://developer.sandbox.co.in/reference/gst-taxpayer-authentication),
[Generating
E-Invoices](https://developer.sandbox.co.in/reference/e-invoice-authentication-api),
and [E-Way
Bills](https://developer.sandbox.co.in/reference/e-way-bill-authentication-api).We
provide these APIs from GSTN-authorised GST Suvidha Providers, handling the
encryption-decryption and signing so you don't have to handle the
complexities.
version: 1.0.0
servers:
- url: https://api.sandbox.co.in
- url: https://test-api.sandbox.co.in
security: []
tags:
- name: Public
- name: Taxpayer
- name: Taxpayer Auth
- name: Returns
- name: GSTR-1 Documents
- name: File GSTR-1
- name: GSTR-2A Documents
- name: GSTR-2B Document
- name: File GSTR-3B
- name: GSTR-4
- name: File GSTR-9
- name: Invoice Management System
- name: GSTR-1A Documents
- name: File GSTR-1A
- name: Ledgers
- name: e-Invoice
- name: Sales e-Invoices for return period
- name: Purchase e-Invoices for return period
- name: Front Office Notices
- name: Front Office
- name: AATO
- name: e-Invoice1
- name: Authentication
- name: e-Invoice12
- name: E-Way Bill
- name: E-Way Bill1
- name: Authentication1
- name: Consignor
- name: Consolidated E-Way Bill
- name: Multi-Vehicle Movement
- name: Consignee
- name: Transporter
- name: Consolidated E-Way Bill1
- name: Multi-vehicle Movement
- name: Common
paths:
/gst/compliance/tax-payer/e-invoice/{irn}:
get:
tags:
- Taxpayer
- e-Invoice
summary: Get E-Invoice by IRN
operationId: getEInvoiceByIrn
parameters:
- name: irn
in: path
description: ''
required: true
example: ''
schema:
type: string
- name: authorization
in: header
description: >-
GST taxpayer access token. For token-generation steps, refer to the
[Generate Taxpayer
Session](/recipes/gst/authentication/generate_tax_payer_session)
recipe, then pass the token in the authorization header.
required: true
example: ''
schema:
type: string
- name: x-api-version
in: header
description: API version
required: false
example: ''
schema:
type: string
default: 1.0.0
- name: x-api-key
in: header
description: API key for identification
required: true
example: ''
schema:
type: string
responses:
'200':
description: >-
200 E-Invoice fetched / 200 EINV30118 Record not found / 200
EINV30119 E-Invoice older than 6 months
content:
application/json:
schema:
type: object
properties:
code:
type: number
example: 200
data:
type: object
properties:
data:
type: object
properties:
RequestDate:
type: string
example: '2024-11-14 13:31:05'
data:
type: object
properties:
AckDt:
type: string
example: '2024-02-22 17:42:00'
AckNo:
type: number
example: 112410188589976
Irn:
type: string
example: >-
7859346583894f8602c10f5a1d4a40265c90824ad63ba999f04836a57aa70e7c
SignedInvoice:
type: string
example: >-
eyJhbGciOiJSUzI1NiIsImtpZCI6IjE1MTNCODIxRUU0NkM3NDlBNjNCODZFMzE4QkY3MTEwOTkyODdEMUYiLCJ4NXQiOiJGUk80SWU1R3gwbW1PNGJqR0w5eEVKa29mUjgiLCJ0eXAiOiJKV1QifQ.eyJkYXRhIjoie1wiQWNrTm9cIjoxMTI0MTAxODg1ODk5NzYsXCJBY2tEdFwiOlwiMjAyNC0wMi0yMiAxNzo0MjowMFwiLFwiSXJuXCI6XCI3ODU5MzQ2NTgzODk0Zjg2MDJjMTBmNWExZDRhNDAyNjVjOTA4MjRhZDYzYmE5OTlmMDQ4MzZhNTdhYTcwZTdjXCIsXCJWZXJzaW9uXCI6XCIxLjFcIixcIlRyYW5EdGxzXCI6e1wiVGF4U2NoXCI6XCJHU1RcIixcIlN1cFR5cFwiOlwiQjJCXCIsXCJSZWdSZXZcIjpcIllcIixcIklnc3RPbkludHJhXCI6XCJOXCJ9LFwiRG9jRHRsc1wiOntcIlR5cFwiOlwiSU5WXCIsXCJOb1wiOlwiRE9DLzExMVwiLFwiRHRcIjpcIjAxLzAxLzIwMjRcIn0sXCJTZWxsZXJEdGxzXCI6e1wiR3N0aW5cIjpcIjI5QUFBQ1EzNzcwRTAwMFwiLFwiTGdsTm1cIjpcIlF1aWNrbyBJbmZvc29mdCBQcml2YXRlIExpbWl0ZWRcIixcIlRyZE5tXCI6XCJRdWlja28gSW5mb3NvZnQgUHJpdmF0ZSBMaW1pdGVkXCIsXCJBZGRyMVwiOlwiNXRoIGJsb2NrLCBrdXZlbXB1IGxheW91dFwiLFwiQWRkcjJcIjpcImt1dmVtcHUgbGF5b3V0XCIsXCJMb2NcIjpcIkJBTkdBTE9SRVwiLFwiUGluXCI6NTYwMDkxLFwiU3RjZFwiOlwiMjlcIixcIlBoXCI6XCI5MDAwMDAwMDAwXCIsXCJFbVwiOlwiYWJjQGdtYWlsLmNvbVwifSxcIkJ1eWVyRHRsc1wiOntcIkdzdGluXCI6XCIyOUFXR1BWNzEwN0IxWjFcIixcIkxnbE5tXCI6XCJYWVogY29tcGFueSBwdnQgbHRkXCIsXCJUcmRObVwiOlwiWFlaIEluZHVzdHJpZXNcIixcIlBvc1wiOlwiMTJcIixcIkFkZHIxXCI6XCI3dGggYmxvY2ssIGt1dmVtcHUgbGF5b3V0XCIsXCJBZGRyMlwiOlwia3V2ZW1wdSBsYXlvdXRcIixcIkxvY1wiOlwiR0FOREhJTkFHQVJcIixcIlBpblwiOjU2MjE2MCxcIlBoXCI6XCI5MTExMTExMTExMVwiLFwiRW1cIjpcInh5ekB5YWhvby5jb21cIixcIlN0Y2RcIjpcIjI5XCJ9LFwiSXRlbUxpc3RcIjpbe1wiSXRlbU5vXCI6MCxcIlNsTm9cIjpcIjFcIixcIklzU2VydmNcIjpcIllcIixcIlByZERlc2NcIjpcIkFQSSBBY2Nlc3NcIixcIkhzbkNkXCI6XCI5OTgzMTRcIixcIlF0eVwiOjEsXCJGcmVlUXR5XCI6MCxcIlVuaXRcIjpcIkJBR1wiLFwiVW5pdFByaWNlXCI6OTk5LFwiVG90QW10XCI6ODQ2LjYyLFwiUHJlVGF4VmFsXCI6ODQ2LjYyLFwiQXNzQW10XCI6ODQ2LjYyLFwiR3N0UnRcIjoxOCxcIklnc3RBbXRcIjoxNTIuMzgsXCJDZ3N0QW10XCI6MCxcIlNnc3RBbXRcIjowLFwiVG90SXRlbVZhbFwiOjk5OX1dLFwiVmFsRHRsc1wiOntcIkFzc1ZhbFwiOjg0Ni42MixcIkNnc3RWYWxcIjowLFwiU2dzdFZhbFwiOjAsXCJJZ3N0VmFsXCI6MTUyLjM4LFwiQ2VzVmFsXCI6MCxcIlN0Q2VzVmFsXCI6MCxcIkRpc2NvdW50XCI6MCxcIk90aENocmdcIjowLFwiUm5kT2ZmQW10XCI6MCxcIlRvdEludlZhbFwiOjk5OX19IiwiaXNzIjoiTklDIFNhbmRib3gifQ.WVQy062ECtQtIgVYLMKT3qQWXNnAlguX2Wb5qMfanhA6ku5H0O_ixU3tYsKhUVxj_vmiZZzhETFEpw0YypimwUF7bl1w4Y7tWvRRP-eP6BxMgmdILltY5l2zStGPm3nMKbKG6lsh02PiK2bdPDGaEBAzz3ZxrHgws4710a-8a5pCTN7EE1n49EGyGvQS9gLBEASYinrzQHI4lzNjY_NTZ6iK5zlah1WWbAVBY0Hg4fH_yC89ydMj_upPJvJkF50X9de8vPUNKBuMP8tpnTgD-eUsE0VjtNCpczUZ9nKRvOUQlz54EVGfa61Yqq5Tn7oPMXOW90h1QAUlZ_7uINP8sQ
SignedQRCode:
type: string
example: >-
eyJhbGciOiJSUzI1NiIsImtpZCI6IjE1MTNCODIxRUU0NkM3NDlBNjNCODZFMzE4QkY3MTEwOTkyODdEMUYiLCJ4NXQiOiJGUk80SWU1R3gwbW1PNGJqR0w5eEVKa29mUjgiLCJ0eXAiOiJKV1QifQ.eyJkYXRhIjoie1wiU2VsbGVyR3N0aW5cIjpcIjI5QUFBQ1EzNzcwRTAwMFwiLFwiQnV5ZXJHc3RpblwiOlwiMjlBV0dQVjcxMDdCMVoxXCIsXCJEb2NOb1wiOlwiRE9DLzExMVwiLFwiRG9jVHlwXCI6XCJJTlZcIixcIkRvY0R0XCI6XCIwMS8wMS8yMDI0XCIsXCJUb3RJbnZWYWxcIjo5OTksXCJJdGVtQ250XCI6MSxcIk1haW5Ic25Db2RlXCI6XCI5OTgzMTRcIixcIklyblwiOlwiNzg1OTM0NjU4Mzg5NGY4NjAyYzEwZjVhMWQ0YTQwMjY1YzkwODI0YWQ2M2JhOTk5ZjA0ODM2YTU3YWE3MGU3Y1wiLFwiSXJuRHRcIjpcIjIwMjQtMDItMjIgMTc6NDI6MDBcIn0iLCJpc3MiOiJOSUMgU2FuZGJveCJ9.BcQeCgE3S9NjLEzoJCADyiG71P-dE5C8PFE3d0TWWay8TEPuEdaShXBZjsAz7-n8VS0vox99Kj1p2_Qbo8pQ4g9NB3h3yC1O-FL9FLokVF6t1pzb5l8_t8Ej4MIzUjTxGhLrW-rFxCyIWuOz6ixzuAaUfyDjXW5mhAVeREXrE0pioMhFuFbnsLkyVLUsxJFk3Jc90fActOyRLm6xgEeJ5oAoR8IpzHySSTMM4_tx910f0u-IuXf59GxLQQAKyjF1UfrRmTjN3sPmDk4SSKxz0aqQ0yS-LHiAx5vL8kSws2Icyri6dS8WLLHR0_cWKs_VWf4xg87oFM5MgKTVq3mdzg
Status:
type: string
example: ACT
error:
type: object
properties:
error_cd:
type: string
example: EINV30118
message:
type: string
example: No record found.
status_cd:
type: string
example: '1'
timestamp:
type: number
example: 1763446641000
transaction_id:
type: string
example: 30a2c438-bc17-44f7-a778-0dc6909ca118
examples:
200 EINV30118 Record not found:
summary: 200 EINV30118 Record not found
value:
code: 200
data:
error:
error_cd: EINV30118
message: No record found.
status_cd: '0'
timestamp: 1763446641000
transaction_id: d4a49c94-da0f-403c-8195-ebc172f77df2
200 EINV30119 e-Invoice older than 6 months:
summary: 200 EINV30119 e-Invoice older than 6 months
value:
code: 200
data:
error:
error_cd: EINV30119
message: >-
Please enter an IRN which is not older than six
months.
status_cd: '0'
timestamp: 1763446641000
transaction_id: 2d60636e-67ee-40c3-9bc3-0a3ad15f9a1b
200 e-Invoice fetched:
summary: 200 e-Invoice fetched
value:
code: 200
data:
data:
RequestDate: '2024-11-14 13:31:05'
data:
AckDt: '2024-02-22 17:42:00'
AckNo: 112410188589976
Irn: >-
7859346583894f8602c10f5a1d4a40265c90824ad63ba999f04836a57aa70e7c
SignedInvoice: >-
eyJhbGciOiJSUzI1NiIsImtpZCI6IjE1MTNCODIxRUU0NkM3NDlBNjNCODZFMzE4QkY3MTEwOTkyODdEMUYiLCJ4NXQiOiJGUk80SWU1R3gwbW1PNGJqR0w5eEVKa29mUjgiLCJ0eXAiOiJKV1QifQ.eyJkYXRhIjoie1wiQWNrTm9cIjoxMTI0MTAxODg1ODk5NzYsXCJBY2tEdFwiOlwiMjAyNC0wMi0yMiAxNzo0MjowMFwiLFwiSXJuXCI6XCI3ODU5MzQ2NTgzODk0Zjg2MDJjMTBmNWExZDRhNDAyNjVjOTA4MjRhZDYzYmE5OTlmMDQ4MzZhNTdhYTcwZTdjXCIsXCJWZXJzaW9uXCI6XCIxLjFcIixcIlRyYW5EdGxzXCI6e1wiVGF4U2NoXCI6XCJHU1RcIixcIlN1cFR5cFwiOlwiQjJCXCIsXCJSZWdSZXZcIjpcIllcIixcIklnc3RPbkludHJhXCI6XCJOXCJ9LFwiRG9jRHRsc1wiOntcIlR5cFwiOlwiSU5WXCIsXCJOb1wiOlwiRE9DLzExMVwiLFwiRHRcIjpcIjAxLzAxLzIwMjRcIn0sXCJTZWxsZXJEdGxzXCI6e1wiR3N0aW5cIjpcIjI5QUFBQ1EzNzcwRTAwMFwiLFwiTGdsTm1cIjpcIlF1aWNrbyBJbmZvc29mdCBQcml2YXRlIExpbWl0ZWRcIixcIlRyZE5tXCI6XCJRdWlja28gSW5mb3NvZnQgUHJpdmF0ZSBMaW1pdGVkXCIsXCJBZGRyMVwiOlwiNXRoIGJsb2NrLCBrdXZlbXB1IGxheW91dFwiLFwiQWRkcjJcIjpcImt1dmVtcHUgbGF5b3V0XCIsXCJMb2NcIjpcIkJBTkdBTE9SRVwiLFwiUGluXCI6NTYwMDkxLFwiU3RjZFwiOlwiMjlcIixcIlBoXCI6XCI5MDAwMDAwMDAwXCIsXCJFbVwiOlwiYWJjQGdtYWlsLmNvbVwifSxcIkJ1eWVyRHRsc1wiOntcIkdzdGluXCI6XCIyOUFXR1BWNzEwN0IxWjFcIixcIkxnbE5tXCI6XCJYWVogY29tcGFueSBwdnQgbHRkXCIsXCJUcmRObVwiOlwiWFlaIEluZHVzdHJpZXNcIixcIlBvc1wiOlwiMTJcIixcIkFkZHIxXCI6XCI3dGggYmxvY2ssIGt1dmVtcHUgbGF5b3V0XCIsXCJBZGRyMlwiOlwia3V2ZW1wdSBsYXlvdXRcIixcIkxvY1wiOlwiR0FOREhJTkFHQVJcIixcIlBpblwiOjU2MjE2MCxcIlBoXCI6XCI5MTExMTExMTExMVwiLFwiRW1cIjpcInh5ekB5YWhvby5jb21cIixcIlN0Y2RcIjpcIjI5XCJ9LFwiSXRlbUxpc3RcIjpbe1wiSXRlbU5vXCI6MCxcIlNsTm9cIjpcIjFcIixcIklzU2VydmNcIjpcIllcIixcIlByZERlc2NcIjpcIkFQSSBBY2Nlc3NcIixcIkhzbkNkXCI6XCI5OTgzMTRcIixcIlF0eVwiOjEsXCJGcmVlUXR5XCI6MCxcIlVuaXRcIjpcIkJBR1wiLFwiVW5pdFByaWNlXCI6OTk5LFwiVG90QW10XCI6ODQ2LjYyLFwiUHJlVGF4VmFsXCI6ODQ2LjYyLFwiQXNzQW10XCI6ODQ2LjYyLFwiR3N0UnRcIjoxOCxcIklnc3RBbXRcIjoxNTIuMzgsXCJDZ3N0QW10XCI6MCxcIlNnc3RBbXRcIjowLFwiVG90SXRlbVZhbFwiOjk5OX1dLFwiVmFsRHRsc1wiOntcIkFzc1ZhbFwiOjg0Ni42MixcIkNnc3RWYWxcIjowLFwiU2dzdFZhbFwiOjAsXCJJZ3N0VmFsXCI6MTUyLjM4LFwiQ2VzVmFsXCI6MCxcIlN0Q2VzVmFsXCI6MCxcIkRpc2NvdW50XCI6MCxcIk90aENocmdcIjowLFwiUm5kT2ZmQW10XCI6MCxcIlRvdEludlZhbFwiOjk5OX19IiwiaXNzIjoiTklDIFNhbmRib3gifQ.WVQy062ECtQtIgVYLMKT3qQWXNnAlguX2Wb5qMfanhA6ku5H0O_ixU3tYsKhUVxj_vmiZZzhETFEpw0YypimwUF7bl1w4Y7tWvRRP-eP6BxMgmdILltY5l2zStGPm3nMKbKG6lsh02PiK2bdPDGaEBAzz3ZxrHgws4710a-8a5pCTN7EE1n49EGyGvQS9gLBEASYinrzQHI4lzNjY_NTZ6iK5zlah1WWbAVBY0Hg4fH_yC89ydMj_upPJvJkF50X9de8vPUNKBuMP8tpnTgD-eUsE0VjtNCpczUZ9nKRvOUQlz54EVGfa61Yqq5Tn7oPMXOW90h1QAUlZ_7uINP8sQ
SignedQRCode: >-
eyJhbGciOiJSUzI1NiIsImtpZCI6IjE1MTNCODIxRUU0NkM3NDlBNjNCODZFMzE4QkY3MTEwOTkyODdEMUYiLCJ4NXQiOiJGUk80SWU1R3gwbW1PNGJqR0w5eEVKa29mUjgiLCJ0eXAiOiJKV1QifQ.eyJkYXRhIjoie1wiU2VsbGVyR3N0aW5cIjpcIjI5QUFBQ1EzNzcwRTAwMFwiLFwiQnV5ZXJHc3RpblwiOlwiMjlBV0dQVjcxMDdCMVoxXCIsXCJEb2NOb1wiOlwiRE9DLzExMVwiLFwiRG9jVHlwXCI6XCJJTlZcIixcIkRvY0R0XCI6XCIwMS8wMS8yMDI0XCIsXCJUb3RJbnZWYWxcIjo5OTksXCJJdGVtQ250XCI6MSxcIk1haW5Ic25Db2RlXCI6XCI5OTgzMTRcIixcIklyblwiOlwiNzg1OTM0NjU4Mzg5NGY4NjAyYzEwZjVhMWQ0YTQwMjY1YzkwODI0YWQ2M2JhOTk5ZjA0ODM2YTU3YWE3MGU3Y1wiLFwiSXJuRHRcIjpcIjIwMjQtMDItMjIgMTc6NDI6MDBcIn0iLCJpc3MiOiJOSUMgU2FuZGJveCJ9.BcQeCgE3S9NjLEzoJCADyiG71P-dE5C8PFE3d0TWWay8TEPuEdaShXBZjsAz7-n8VS0vox99Kj1p2_Qbo8pQ4g9NB3h3yC1O-FL9FLokVF6t1pzb5l8_t8Ej4MIzUjTxGhLrW-rFxCyIWuOz6ixzuAaUfyDjXW5mhAVeREXrE0pioMhFuFbnsLkyVLUsxJFk3Jc90fActOyRLm6xgEeJ5oAoR8IpzHySSTMM4_tx910f0u-IuXf59GxLQQAKyjF1UfrRmTjN3sPmDk4SSKxz0aqQ0yS-LHiAx5vL8kSws2Icyri6dS8WLLHR0_cWKs_VWf4xg87oFM5MgKTVq3mdzg
Status: ACT
status_cd: '1'
timestamp: 1763446641000
transaction_id: 30a2c438-bc17-44f7-a778-0dc6909ca118
headers: {}
deprecated: false
security: []
````