DIdigitax
Invoice verification

Verify an invoice

Submits an invoice for verification against KRA using its invoice number.

post/invoice-verifications

Request

  • Base URL
    https://api.digitax.tech/ke/v2
  • Auth
    API key in header X-API-Key

Request body

invoice_numberstring required

The invoice number to verify.

amountinteger

The invoice amount to use for verification.

supplier_pinstring

The tax identification PIN of the supplier.

reference_numberstring

The reference number associated with the invoice verification.

Example request

{
  "invoice_number": "KRACU0300000024/39",
  "amount": 2000,
  "supplier_pin": "P000614502H",
  "reference_number": "P000614502H"
}

Response

Success

statusstring required

The status of the invoice verification.

created_atstring required

The date-time when the verification record was created (ISO 8601)

source'EXTERNAL' | 'INTERNAL' required

Source of the verification. Possible values are EXTERNAL and INTERNAL. EXTERNAL means the invoice is being verified for the first time; so the data was verified against KRA eTIMS. The source for subsequent verifications of the same invoice will be INTERNAL; since data from the first attempt is saved and used for subsequent validations.

Example response

{
  "status": "success",
  "created_at": "2026-07-14T15:09:02.036Z",
  "data": {
    "invoice_timestamp": "2026-07-14T10:23:06Z",
    "number_of_items": 2,
    "invoice_number": "KRACU0300000024/39",
    "verification_date": "2026-07-14T15:09:02.036Z"
  },
  "source": "EXTERNAL"
}

Changes

No recorded changes to this operation across all 2 revisions of this API.