v1

latestOpenAPI 3.0.1Apache 2.02026-07-26401961.7 KB

Invoice verification

Verify an invoice

post/invoice-verifications

Request body

invoice_numberstring required

amountinteger

supplier_pinstring

reference_numberstring

Example request

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

Response

Success

statusstring required

Verification status

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"
}