Validate IRN
base_url: https://firseinvoicedemo.etranzactng.com
- Sample Request
- Sample Response
Request Parameters
| Parameter | Type | Description | Required? |
|---|---|---|---|
| irn | string | A unique tracking number assigned to each invoice. | Yes |
| business_id | string | Unique alphanumeric ID generated when the business is registered on the e-invoicing platform. It allows the system recognize all invoices generated by the company | Yes |
| invoice_number | string | Taxpayer’s Invoice/transaction reference value (transaction id) | Yes |
Response Parameters
| Parameter | Type | Description | Required? |
|---|---|---|---|
| status | integer | HTTP status code | Yes |
| message | string | Description of http status code | Yes |
| irn | string | A unique tracking number assigned to each invoice. | Yes |
| execTime | integer | Time taken to process request (for metrics and performance tracking) | Yes |
| error | integer | Specific errors when request does not return a HTTP status of 200 | No |
- Sample Request
- Sample Response
Request Parameters
POST {base_url}/api/v1/app/invoice/validate-irn
curl -X POST `{base_url}/api/v1/app/invoice/validate-irn`
-H "X-API-Key: {{CLIENT_API_KEY}}"
-H "X-API-Signature: {{HMAC_SHA256_SIGNATURE}}"
-H "X-API-Timestamp: {{ISO_20022_TIMESTAMP}}"
-H "Content-Type: application/json"
-d '{
"irn": "INV285-47AT78FN-20250417",
"business_id": "6f19a0f0-c8f3-4d2b-8a8b-1b2c45e89d0f",
}
'
Sample Success Response
POST {base_url}/api/v1/app/invoice/validate-irn
{
"status": 200,
"message": "IRN generated successfully.",
"data": {
"irn": "INV285-47AT78FN-20250417"
},
"execTime": 1.388868,
"error": ""
}