---
title: "Get sales"
method: GET
path: "/sales"
tags: ["Sales"]
---

# Get sales

`GET /sales`

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

## Query parameters

- `start_date` string — Start date (YYYY-MM-DD) - sales returned will be inclusive of this date
- `end_date` string — End date (YYYY-MM-DD) - sales returned will be inclusive of this date
- `before` string — When paginating results, a pointer to an ID before which we want results
- `after` string — When paginating results, a pointer to an ID after which we want results
- `page_size` integer — The maximum number of items to return per page, defaults to 20

## Response `200`

Success

- object
  - `pagination` Pagination, required
    - `next` string
    - `previous` string
    - `page_size` integer
  - `data` Sale[], required
    - `id` string, required
    - `date` string, required — The receipt date (DD/MM/YYYY), as printed on the physical receipt
    - `time` string, required
    - `trader_invoice_number` string, required
    - `receipt_type_code` string, required
    - `sale_detail_url` string, url, required
    - `serial_number` string, required
    - `receipt_number` integer, required
    - `invoice_number` integer, required
    - `customer_id` string, required
    - `customer_name` string, required
    - `customer_tin` string, required
    - `customer_phone_number` string
    - `customer_email` string
    - `internal_data` string, required
    - `receipt_signature` string, required
    - `etims_url` string, url, required
    - `original_sale_id` string
    - `offline_url` string, url
    - `status` 'PENDING' | 'FAILED' | 'COMPLETED' — status against KRA
    - `sales_tax_summary` object, required
      - `taxable_amount_a` number, required
      - `taxable_amount_b` number, required
      - `taxable_amount_c` number, required
      - `taxable_amount_d` number, required
      - `taxable_amount_e` number, required
      - `tax_rate_a` integer, required
      - `tax_rate_b` integer, required
      - `tax_rate_c` integer, required
      - `tax_rate_d` integer, required
      - `tax_rate_e` integer, required
      - `catering_levy_rate` integer
      - `service_charge_rate` integer
      - `tax_amount_a` number, required
      - `tax_amount_b` number, required
      - `tax_amount_c` number, required
      - `tax_amount_d` number, required
      - `tax_amount_e` number, required
      - `catering_levy_amount` number
      - `service_charge_amount` number
    - `item_list` SaleItem[]
      - `id` string, required
      - `quantity` number, required
      - `unit_price` number, required
      - `total_amount` number, required
      - `taxable_amount` number, required
      - `tax_amount` number, required
      - `tax_rate` number, required
      - `tax_type_code` string, required
      - `discount_rate` number, required
      - `discount_amount` number, required
      - `etims_item_code` string, required
      - `is_stockable` boolean, required
      - `item_id` string, required

## 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/versions/1fc0cdf61f70/schema)