Get your eTIMS sales receipts through an API

What you can build on the eTIMS portal

• Get sales receipts

  Build this

  Reads the Sales Receipt list under Transaction Management, with each row's receipt number and invoice number, for the dates you choose.

  Takes

  From date, to date

  Returns

  Receipt number, invoice number, date, customer name, customer PIN, payment type, taxable supply price, VAT, total

• Get a receipt's information

  Build this

  Opens one receipt from the Sales Receipt list by its receipt number and reads the receipt information, with every line of the Sales Item List.

  Takes

  Receipt number

  Returns

  Receipt number, invoice number, customer, payment type, items, quantity, unit price, discount, taxable supply price, VAT

• Get registered items

  Build this

  Reads Search Registered Item under Item Management: the items and services you can sell, each with its Item Class Code.

  Takes

  Item name (optional)

  Returns

  Item code, item name, item class code, quantity unit

• Issue a sales receipt

  Build this

  Adds a sale in Sales Receipt: picks a registered customer or enters a B2C name and mobile number, sets the payment type, fills the Sales Item List and saves.

  Takes

  Customer PIN or name and mobile number, payment type, items with quantity, unit price and discount

  Returns

  Receipt number, invoice number, taxable supply price, VAT, total

Automate the eTIMS portal with a workflow

A workflow runs your methods as one process, with nobody at the screen. A schedule or a call from your own system starts it, the steps run in order, and the result arrives in your inbox or in the systems you already use.

• Last week's sales receipts, posted to your accounting system

  Build this

  Starts

  Every Monday at 8:00, Nairobi time

  Step 1

  Get the sales receipts from last Monday to Sunday.

  Step 2

  Keep the receipts that were not there on the last run.

  Step 3

  Post each one, with its invoice number, customer, taxable supply price and VAT, to your accounting system's webhook.

• Monthly receipt count against the 10-invoice limit

  Build this

  Starts

  Every weekday at 17:00, Nairobi time

  Step 1

  Get the sales receipts from the first day of this month to today.

  Step 2

  Stop when there are fewer than 8.

  Step 3

  Email you the count and the list, with receipt number, invoice number, customer and total.

You can run a workflow by hand on every plan, Free included. Schedules and webhook triggers come with the paid plans, from $29 a month.

Once built, one call from your code

Once you have built a method, it is one POST to /v1/runs from your backend, or a tool an AI agent calls over MCP. This is what “Get sales receipts” would look like.

curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "etims.kra.go.ke/get_sales_receipts",
    "input": {
      "from_date": "2026-11-02",
      "to_date": "2026-11-08"
    }
  }'

{
  "status": "completed",
  "data": {
    "receipts": [
      {
        "receipt_number": 14,
        "invoice_number": 14,
        "date": "2026-11-06",
        "customer_name": "Northwind Logistics Ltd",
        "customer_pin": "P051000001Z",
        "payment_type": "Bank transfer",
        "taxable_supply_price": 86206.9,
        "vat": 13793.1,
        "total": 100000
      }
    ],
    "count": 1
  }
}

An example with invented data, not a ready-made endpoint. The method exists in your organization once you build it, and its name, inputs and fields follow your request.

The eTIMS portal’s own options

KRA offers several eTIMS solutions, all for issuing electronic tax invoices: the online portal, the eTIMS Client software, eTIMS Lite and system-to-system integration through OSCU or VSCU. OSCU and VSCU connect your own invoicing system to eTIMS after you build and test against KRA's sandbox and pass KRA's certification, or through a KRA-approved third-party integrator.

Read on November 12, 2026: eTIMS System to System Integration, eTIMS solution information page, Types of eTIMS solutions.

Signing in to the eTIMS portal

The eTIMS portal signs you in with your KRA PIN as the User ID and a password. You set that password at sign-up, after verifying your PIN with a security code sent to your phone and email. With Fous you sign in once through the portal's own sign-in with your own account: the login is sealed with AES-256, and an expired session is signed back in.

Worth knowing

Ten invoices a month, services only

KRA makes the online portal for taxpayers in the service sector who issue no more than 10 invoices a month. Busier sellers and sellers of goods use another eTIMS solution, such as the eTIMS Client or OSCU and VSCU.

Register items before you sell them

A sale picks from Search Registered Item. Each item needs an Item Class Code, found with Search Item Classification and Search UNSPSC, and a quantity unit before it can go on a Sales Item List.

Credit notes stay in their own solution

Each eTIMS solution keeps its own invoice number sequence, and a credit note can only be raised in the solution where the invoice was issued. Invoices from every solution can be viewed in the portal.

KRA approves your application first

After sign-up you apply for the eTIMS 2.1 solution under Service Request. An authorized KRA officer verifies and approves the application before you can invoice.

More in Government: Middle East and Africa

• CAC Company Registration Portal
• CIPC eServices
• GDRFA Dubai Smart Services
• Rev360
• Qiwa
• ICP Smart Services
• KRA iTax
• SARS eFiling
• SIMPL
• Egyptian Tax Authority e-Services
• ZATCA e-Services
• uFiling
• EmaraTax
• Mudad

Other industries: EU Funding & Tenders Portal, Chorus Pro, Accela Citizen Access, Desktop Underwriter, USPS Business Customer Gateway, Bonfire.