---
title: "Verify an invoice"
method: POST
path: "/invoice-verifications"
tags: ["Invoice verification"]
---

# Verify an invoice

`POST /invoice-verifications`

Verify an invoice

## Request body

- object
  - `invoice_number` string, required
  - `amount` integer
  - `supplier_pin` string
  - `reference_number` string

## Response `201`

Success

- InvoiceVerification
  - `status` string, required — Verification status
  - `created_at` string, required — The date-time when the verification record was created (ISO 8601)
  - `data` VerificationDetail
    - `invoice_timestamp` string, required — Invoice timestamp (ISO 8601)
    - `number_of_items` integer, required — Number of items in the invoice
    - `invoice_number` string, required — Invoice number
    - `verification_date` string, required — Date invoice was verified for the first time against KRA eTIMS (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.

## Other responses

- `default` — Error response

---

[API](https://skmtc.net/digitax/apis/digitax-kenya-api-endpoints.md) · [All operations](https://skmtc.net/digitax/apis/digitax-kenya-api-endpoints/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/digitax/digitax-kenya-api-endpoints/revisions/1fc0cdf61f70/schema)