We’re excited to launch our latest product to simplify your business processes. Know More →
GST Public GST, e-Invoice & e-Way Bill RPACPC GST Suite

Retrieve E-Invoice Reference Details Through an API.

Integrate e-invoice reference number searches into your business applications using the RPACPC IRN Search API. Retrieve the available IRN registration and cancellation details to support invoice-related workflows and GST data processing.

Sample verification Dummy data
1 You send
Checking
2 You get back
✓
ACTIVEValid & registered
482 ms
Invoice Reference Number (IRN) dummy_irn_hash_1234567890abcdef
Status ✓ REGISTERED
IRN Name DUMMY-NIC
Registration Date & Time 15/01/2025 10:30:00
Cancellation Date & Time N/A
API overview

Simplify IRN Search Verification.

The RPACPC IRN Search API allows an application to search for an Invoice Reference Number (IRN) and retrieve associated e-invoice information.

The supplied response includes the IRN, registration and cancellation system identifiers, current status, and registration and cancellation timestamps when present.

This API can be integrated into invoice management, accounting, ERP, and GST-related applications that need to process IRN information.

Key Information Available

Access essential IRN details.

The API response may include the following information, depending on the response received:

01
Invoice Reference Number

Invoice Reference Number returned by the API.

irn
02
Registration System Identifier

Registration-related system identifier returned by the API.

regirp
03
Cancellation System Identifier

Cancellation-related system identifier returned by the API.

cnclirp
04
IRN Status

Status value indicating the current IRN state.

status
05
Registration Timestamp

Date and time when the IRN was registered.

regtime
06
Cancellation Timestamp

Date and time when the IRN was cancelled, if applicable.

cncltime
The response example uses NIC for both regirp and cnclirp, and CNL for status. Confirm the official code definitions before displaying these values as expanded descriptions in your application.
How It Works

Simple API-based verification process.

Step 01

Provide the IRN

Submit the Invoice Reference Number you want to search using the irn parameter.

Step 02

Send the Request

Call the IRN Search endpoint using the GET method.

Step 03

Receive the Response

Retrieve the available IRN information, including its status and registration or cancellation timestamps.

Step 04

Integrate the Results

Use the returned IRN details in your invoice tracking, accounting, or GST-related workflows.

API Request

Step 1 Submit IRN Search details.

Request parameters
Parameter Type Description
irn String Invoice Reference Number (IRN) to search.
Replace YOUR_IRN_VALUE with the IRN you want to search. Follow the authentication requirements specified in your RPACPC integration documentation.
Sample request REQUEST
{
  "consent": "Y",
  "consent_text": "I hereby declare my consent agreement for fetching my information via RPACPC API",
  "request_id": "DUMMY-REQ-001",
  "irn_code": "dummy_irn_hash_1234567890abcdef"
}
API response

Step 2Receive structured IRN Search API information.

Key response fields
Field Description
status Overall API response status.
status_code Status code returned by the API.
message Message returned by the API.
billable Indicates whether the API response is billable.
error Error information, or null if no error is returned.
data.invoice_reference_number Invoice Reference Number (IRN) returned by the API.
data.status IRN registration status.
data.irn_name Name associated with the IRN record.
data.date_and_time_of_registration Date and time when the IRN was registered.
data.date_and_time_of_cancellation Date and time when the IRN was cancelled, if applicable.
request_id Identifier associated with the API request.
sequence_id Sequence identifier returned by the API.
request_time Timestamp when the request was made.
response_time Timestamp when the response was returned.
200 · Sample responseRESPONSE
{
  "status": "SUCCESS",
  "status_code": "200",
  "message": "Dummy data fetched successfully",
  "billable": "N",
  "error": null,
  "data": {
    "invoice_reference_number": "dummy_irn_hash_1234567890abcdef",
    "status": "REGISTERED",
    "irn_name": "DUMMY-NIC",
    "date_and_time_of_registration": "2025-01-15 10:30:00",
    "date_and_time_of_cancellation": ""
  },
  "request_id": "DUMMY-REQ-001",
  "sequence_id": "dummy-sequence-id-001",
  "request_time": "2026-10-21T10:15:00.000Z",
  "response_time": "2026-10-21T10:15:00.500Z"
}

The IRN has been replaced with a placeholder. The status and timestamp values illustrate the supplied response structure; confirm the status-code definitions before interpreting them in customer-facing documentation.

Use cases

IRN verification across business workflows.

E-Invoice Status Lookup

Retrieve the status value associated with an IRN for use in invoice-related workflows.

Invoice Management Systems

Integrate IRN searches into invoice management applications to access available registration and cancellation information.

ERP and Accounting Integration

Connect IRN lookup with accounting or ERP systems that process e-invoice data.

Invoice Reconciliation

Use the returned IRN and status information as inputs to internal invoice reconciliation workflows.

GST Workflow Automation

Incorporate IRN search into broader GST-related applications and automated business processes.

FAQ

Frequently asked questions

Common questions about the IRN Verification API — what it returns, how fast it is, and how to integrate.

Still have a question? Talk to an expert
What is an IRN?
IRN stands for Invoice Reference Number. It is the identifier associated with an e-invoice in the relevant e-invoicing process.
What does the IRN Search API return?
Based on the supplied response, it returns the IRN, registration and cancellation system identifiers, status, and registration and cancellation timestamps.
Which request parameter is required?
The supplied endpoint uses the irn query parameter to specify the Invoice Reference Number to search.
What does the status value CNL mean?
The example contains CNL, but the supplied API sample does not include a code dictionary. Confirm the official mapping before publishing an expanded meaning.
Are registration and cancellation timestamps always returned?
Both fields appear in the supplied response. Whether they are present in every response should be confirmed against the API's behavior for different IRN statuses.
Does this API generate or cancel an IRN?
The supplied endpoint is for searching an IRN. Separate Generate IRN and Cancel IRN APIs are listed in the RPACPC GST API inventory.
How can I access the API?
Contact the RPACPC team for authentication details, access requirements, and integration guidance.
Blog

Government ID Check API: How Does It Help Banks, FinTechs, and NBFCs Streamline KYC?

Government ID Check API helps banks, FinTechs, and NBFCs streamline KYC with faster identity verification and reduced manual work.

Read More
Government ID Check API: How Does It Help Banks, FinTechs, and NBFCs Streamline KYC?

India's verification infrastructure is already here.

Empower your applications with India's Enterprise Verification Intelligence Platform for faster, more reliable verification.