v1

latestOpenAPI 3.0.1Apache 2.02026-07-26401961.7 KB

Sales

Get sales

List sales for a particular business. If an end_date is provided without a start_date, all sales will be returned.

get/sales

Query parameters

start_datestring

Start date (YYYY-MM-DD) - sales returned will be inclusive of this date

Example:2026-07-14

end_datestring

End date (YYYY-MM-DD) - sales returned will be inclusive of this date

Example:2026-07-14

beforestring

When paginating results, a pointer to an ID before which we want results

Example:<entity>_01HC3J1VVVM05YCTS61G7V3KC6

afterstring

When paginating results, a pointer to an ID after which we want results

Example:<entity>_01HC3J1VVVM05YCTS61G7V3KC6

page_sizeinteger

The maximum number of items to return per page, defaults to 20

Example:20

Response

Success

Example response

{
  "pagination": {
    "next": "<entity>_01HC3J1VVVM05YCTS61G7V3KC6",
    "previous": "<entity>_01HC3J1VVVM05YCTS61G7V3KC6",
    "page_size": 20
  },
  "data": [
    {
      "id": "sale_01HC3HTDAXQ50E07CWR2A2CFBD",
      "date": "14/07/2026",
      "time": "04:16:11 pm",
      "trader_invoice_number": "12345678901",
      "receipt_type_code": "S",
      "sale_detail_url": "https://api.digitax.tech/sales/YKSWCIiuvx",
      "serial_number": "KRACU0400000001",
      "receipt_number": 38,
      "invoice_number": 38,
      "customer_id": "customer_01HC3HTDAXQ50E07CWR2A2CFBD",
      "customer_name": "John Doe",
      "customer_tin": "P123456789P",
      "customer_phone_number": "+254112685368",
      "customer_email": "info@namiri.tech",
      "internal_data": "PB3ZSZP3RZR3AUPYBYLUTFJDIA",
      "receipt_signature": "3JYZVPTPMYBGHG4A",
      "etims_url": "https://etims.kra.go.ke/common/link/etims/receipt/indexEtimsReceptData?{P053100692D+00+3JYZVPTPMYBGHG4A}",
      "original_sale_id": "sale_01HC3HTDAXQ50E07CWR2A2CFBD",
      "offline_url": "https://receipt.dg.tax/r/business_01JGXVVP4Z3MWQBQ3XSCJ3S4JF/SAL25-204-145657411-MHARTQ",
      "status": "completed",
      "sales_tax_summary": {
        "taxable_amount_b": 517.24,
        "tax_rate_b": 16,
        "tax_rate_e": 8,
        "catering_levy_rate": 2,
        "tax_amount_b": 82.76
      },
      "item_list": [
        {
          "id": "saleitem_01HC3J1VVVM05YCTS61G7V3KC6",
          "quantity": 1,
          "unit_price": 600,
          "total_amount": 600,
          "taxable_amount": 517.24,
          "tax_amount": 82.76,
          "tax_rate": 16,
          "tax_type_code": "B",
          "etims_item_code": "KE3NTU12345678",
          "item_id": "item_01HC3J1VVVM05YCTS61G7V3KC6"
        }
      ]
    }
  ]
}