tax&go
Sign inGet Started

Documentation

tax&go eTIMS API

Complete reference for the tax&go Kenya Revenue Authority eTIMS OSCU integration API. Submit invoices, register items, and stay compliant with Kenya Revenue Authority requirements.

Base URL

https://staging-ushuru-api.piviotech.com/api/v1

Version: v1.0

Format: JSON

Key Endpoints

GET
/api/v1/health

Check service availability

GET
/api/v1/status

Device and taxpayer status

POST
/api/v1/initialize

Initialize device and sync reference data

POST
/api/v1/sync

Sync latest reference data from Kenya Revenue Authority

GET
/api/v1/codes

Fetch Kenya Revenue Authority code lookup tables

GET
/api/v1/customers/:pin

Look up a buyer by Kenya Revenue Authority PIN

POST
/api/v1/items/service

Register a service item

POST
/api/v1/items/goods

Register a physical goods item

GET
/api/v1/items

List all registered items

POST
/api/v1/sales

Submit a sales invoice to Kenya Revenue Authority

POST
/api/v1/sales/credit-note

Issue a credit note for a prior sale

GET
/api/v1/purchases

Fetch incoming purchase invoices

POST
/api/v1/purchases

Confirm receipt of a purchase invoice

POST
/api/v1/stock/io

Record a stock movement transaction

PUT
/api/v1/stock/master

Update master stock quantity for an item

67 endpoints documented. Use the sidebar to browse the full API reference.