Invoices

Validate invoice schema

POST {{BASE_URL}}/api/v1/einvoice/validate Validates your invoice payload before signing. Use this to catch schema and compliance issues early. Request example:

{
  "business_id": "{{BUSINESS_ID}}",
  "irn": "{{IRN}}",
  "issue_date": "2024-05-14",
  "due_date": "2024-06-14",
  "issue_time": "17:59:04",
  "invoice_type_code": "381",
  "invoice_kind": "B2B",
  "payment_status": "PENDING",
  "note": "Invoice note",
  "tax_point_date": "2024-05-14",
  "document_currency_code": "NGN",
  "tax_currency_code": "NGN",
  "accounting_supplier_party": {
    "party_name": "TITAN BRIDGE DYNAMIC WORLD LTD",
    "tin": "24058123-0002",
    "email": "test_sender@pasca.co",
    "telephone": "+23480254099000",
    "business_description": "Business description",
    "postal_address": {
      "street_name": "32, Owonikoko Street",
      "city_name": "Gwarikpa",
      "postal_zone": "023401",
      "lga": "NG-AB-ANO",
      "state": "NG-AB",
      "country": "NG"
    }
  },
  "accounting_customer_party": {
    "party_name": "Dangote Group",
    "tin": "72382732-0001",
    "email": "business@email.com",
    "telephone": "+23480254000000",
    "business_description": "Sales of cement and building materials",
    "postal_address": {
      "street_name": "32, Owonikoko Street",
      "city_name": "Gwarikpa",
      "postal_zone": "023401",
      "lga": "NG-AB-ANO",
      "state": "NG-AB",
      "country": "NG"
    }
  },
  "payment_means": [
    {
      "payment_means_code": "10",
      "payment_due_date": "2024-05-14"
    }
  ],
  "tax_total": [
    {
      "tax_amount": 56.07,
      "tax_subtotal": [
        {
          "taxable_amount": 800,
          "tax_amount": 8,
          "tax_category": {
            "id": "LOCAL_SALES_TAX",
            "percent": 2.3
          }
        }
      ]
    }
  ],
  "legal_monetary_total": {
    "line_extension_amount": 10,
    "tax_exclusive_amount": 10,
    "tax_inclusive_amount": 10,
    "payable_amount": 10
  },
  "invoice_line": [
    {
      "hsn_code": "CC-111",
      "product_category": "Food and Beverages",
      "discount_rate": 2.01,
      "discount_amount": 3500,
      "fee_rate": 1.01,
      "fee_amount": 50,
      "invoiced_quantity": 15,
      "line_extension_amount": 30,
      "item": {
        "name": "Tomato Paste",
        "description": "Description of the tomato paste",
        "sellers_item_identification": "Spoon"
      },
      "price": {
        "price_amount": 1150,
        "base_quantity": 1,
        "price_unit": "NGN per 1"
      }
    }
  ]
}

Response example (success):

{
  "status": true,
  "code": 200,
  "message": "Invoice validated sucessfully",
  "data": []
}

Response example (error):

{
  "status": false,
  "code": 400,
  "message": "Failed to validate invoice",
  "data": null,
  "error": {
    "id": "5c4c008e-8f1e-4034-a96b-8b352c143da5",
    "handler": "invoice_actions",
    "details": "this business does not exist",
    "public_message": "validation failed"
  }
}

Fields:

business_id: PASCA business identifier.
irn: Invoice Reference Number.
invoice_type_code: Invoice type code from resources.
invoice_kind: Invoice type such as B2B.
accounting_supplier_party: Supplier identity and address.
accounting_customer_party: Customer identity and address.
invoice_line: Line items for products or services.
legal_monetary_total: Invoice totals.

Sign invoice

POST {{BASE_URL}}/api/v1/einvoice/sign Signs an invoice and generates an IRN. Use this after validation. Request example:

{
  "business_id": "{{BUSINESS_ID}}",
  "irn": "{{IRN}}",
  "issue_date": "2024-05-14",
  "invoice_type_code": "396",
  "document_currency_code": "NGN",
  "tax_currency_code": "NGN",
  "invoice_kind": "B2B",
  "accounting_customer_party": {
    "party_name": "Test Accounting Customer Party",
    "tin": "83526544-2627",
    "email": "test_sender@pasca.co",
    "telephone": "+23480254099000",
    "business_description": "Sample business description",
    "postal_address": {
      "street_name": "32, Owonikoko Street",
      "city_name": "Gwarikpa",
      "postal_zone": "023401",
      "lga": "NG-AB-ANO",
      "state": "NG-AB",
      "country": "NG"
    }
  },
  "accounting_supplier_party": {
    "party_name": "Dangote Group",
    "tin": "33824622-7135",
    "email": "tobi@pasca.co",
    "telephone": "+2348168527167",
    "business_description": "Supplier details",
    "postal_address": {
      "street_name": "32, Owonikoko Street",
      "city_name": "Gwarikpa",
      "postal_zone": "023401",
      "lga": "NG-AB-ANO",
      "state": "NG-AB",
      "country": "NG"
    }
  },
  "legal_monetary_total": {
    "line_extension_amount": 340.5,
    "tax_exclusive_amount": 400,
    "tax_inclusive_amount": 430,
    "payable_amount": 1500000
  },
  "invoice_line": [
    {
      "hsn_code": "CC-001",
      "product_category": "Food and Beverages",
      "discount_rate": 2.01,
      "discount_amount": 3500,
      "fee_rate": 1.01,
      "fee_amount": 50,
      "invoiced_quantity": 15,
      "line_extension_amount": 30,
      "item": {
        "name": "Tomato Paste",
        "description": "Description of the tomato paste",
        "sellers_item_identification": "Spoon"
      },
      "price": {
        "price_amount": 1150,
        "base_quantity": 1,
        "price_unit": "NGN per 1"
      }
    }
  ]
}

Response example (success):

{
  "status": true,
  "code": 200,
  "message": "Invoice signed successfully",
  "data": []
}

Response example (error):

{
  "status": false,
  "code": 400,
  "message": "IRN already exists.",
  "data": null,
  "error": [],
  "timestamp": "2025-09-23T11:09:04.747826Z"
}

Sign and transmit invoice

POST {{BASE_URL}}/api/v1/einvoice/sign-transmit Signs and transmits an invoice to NRS in a single request. Request example:

{
  "business_id": "{{BUSINESS_ID}}",
  "irn": "{{IRN}}",
  "issue_date": "2024-05-14",
  "invoice_type_code": "396",
  "document_currency_code": "NGN",
  "tax_currency_code": "NGN",
  "invoice_kind": "B2B",
  "accounting_customer_party": {
    "party_name": "TITAN BRIDGE DYNAMIC WORLD LTD",
    "tin": "83526544-2627",
    "email": "test_sender@pasca.co",
    "telephone": "+23480254099000",
    "business_description": "Business description",
    "postal_address": {
      "street_name": "32, Owonikoko Street",
      "city_name": "Gwarikpa",
      "postal_zone": "023401",
      "lga": "NG-AB-ANO",
      "state": "NG-AB",
      "country": "NG"
    }
  },
  "accounting_supplier_party": {
    "party_name": "Dangote Group",
    "tin": "33824622-7135",
    "email": "tobi@pasca.co",
    "telephone": "+2348168527167",
    "business_description": "Supplier details",
    "postal_address": {
      "street_name": "32, Owonikoko Street",
      "city_name": "Gwarikpa",
      "postal_zone": "023401",
      "lga": "NG-AB-ANO",
      "state": "NG-AB",
      "country": "NG"
    }
  },
  "legal_monetary_total": {
    "line_extension_amount": 340.5,
    "tax_exclusive_amount": 400,
    "tax_inclusive_amount": 430,
    "payable_amount": 1500000
  },
  "invoice_line": [
    {
      "hsn_code": "CC-001",
      "product_category": "Food and Beverages",
      "discount_rate": 2.01,
      "discount_amount": 3500,
      "fee_rate": 1.01,
      "fee_amount": 50,
      "invoiced_quantity": 15,
      "line_extension_amount": 30,
      "item": {
        "name": "Tomato Paste",
        "description": "Description of the tomato paste",
        "sellers_item_identification": "Spoon"
      },
      "price": {
        "price_amount": 1150,
        "base_quantity": 1,
        "price_unit": "NGN per 1"
      }
    }
  ]
}

Response example (success):

{
  "status": true,
  "code": 200,
  "message": "Invoice transmitted successfully!",
  "data": []
}

Transmit invoice

GET {{BASE_URL}}/api/v1/einvoice/transmit/{IRN} Transmits a previously signed invoice using its IRN. Request example:

curl -X GET "{{BASE_URL}}/api/v1/einvoice/transmit/{{IRN}}" \
  -H "API-KEY: <your_api_key>" \
  -H "API-SECRET: <your_api_secret>" \
  -H "Accept: application/json"

Response format:

{
  "status": true,
  "code": 200,
  "message": "Invoice transmitted successfully",
  "data": []
}

Get invoice (simple)

GET {{BASE_URL}}/api/v1/einvoice/{IRN}/simple Returns a simplified view of a stored invoice. Request example:

curl -X GET "{{BASE_URL}}/api/v1/einvoice/{{IRN}}/simple" \
  -H "API-KEY: <your_api_key>" \
  -H "API-SECRET: <your_api_secret>" \
  -H "Accept: application/json"

Response format:

{
  "status": true,
  "code": 200,
  "message": "Invoice fetched successfully",
  "data": {}
}

Get invoice (advanced)

GET {{BASE_URL}}/api/v1/einvoice/{IRN} Returns the full invoice record with all metadata. Request example:

curl -X GET "{{BASE_URL}}/api/v1/einvoice/{{IRN}}" \
  -H "API-KEY: <your_api_key>" \
  -H "API-SECRET: <your_api_secret>" \
  -H "Accept: application/json"

Response format:

{
  "status": true,
  "code": 200,
  "message": "Invoice fetched successfully",
  "data": {}
}

Lookup IRN status

GET {{BASE_URL}}/api/v1/einvoice/lookup/{IRN} Returns fiscalization status for an IRN. Request example:

curl -X GET "{{BASE_URL}}/api/v1/einvoice/lookup/{{IRN}}" \
  -H "API-KEY: <your_api_key>" \
  -H "API-SECRET: <your_api_secret>" \
  -H "Accept: application/json"

Response format:

{
  "status": true,
  "code": 200,
  "message": "Lookup completed",
  "data": {}
}

Update invoice

PATCH {{BASE_URL}}/api/v1/einvoice/update/{IRN} Updates the payment status or reference for a stored invoice. Request example:

{
  "payment_status": "REJECTED",
  "reference": "payment_reference_or_note"
}

Response format:

{
  "status": true,
  "code": 200,
  "message": "Invoice updated successfully",
  "data": []
}

Fields:

payment_status: One of PENDING, PAID, or REJECTED.
reference: Optional payment reference or note.

Report e-invoice

POST {{BASE_URL}}/api/v1/einvoice/report-fiscalization Reports a fiscalized invoice and its tax details. Request example:

{
  "agent_tin": "29039239-0001",
  "base_amount": "1000",
  "beneficiary_tin": "29334238-0001",
  "currency": "NGN",
  "item_description": "Items",
  "irn": "{{IRN}}",
  "other_taxes": "5000",
  "total_amount": "112500",
  "transaction_date": "2024-11-18",
  "vat_calculated": "7500",
  "vat_rate": "7.5",
  "vat_status": "STANDARD_VAT"
}

Response format:

{
  "status": true,
  "code": 200,
  "message": "Report submitted successfully",
  "data": []
}

Overview

Core modules

Endpoints

Errors and webhooks

Validate invoice schema

Sign invoice

Sign and transmit invoice

Transmit invoice

Get invoice (simple)

Get invoice (advanced)

Lookup IRN status

Update invoice

Report e-invoice

​Validate invoice schema

​Sign invoice

​Sign and transmit invoice

​Transmit invoice

​Get invoice (simple)

​Get invoice (advanced)

​Lookup IRN status

​Update invoice

​Report e-invoice

Validate invoice schema

Sign invoice

Sign and transmit invoice

Transmit invoice

Get invoice (simple)

Get invoice (advanced)

Lookup IRN status

Update invoice

Report e-invoice