---
title: "List items"
method: GET
path: "/items/"
tags: ["Items"]
---

# List items

`GET /items/`

Endpoint for retrieving a list of items.

## Query parameters

- `created_ts_after` string, date-time
- `created_ts_before` string, date-time
- `external_id` string
- `modified_ts_after` string, date-time
- `modified_ts_before` string, date-time
- `page` integer
- `page_size` integer

## Response `200`

- PaginatedItemList
  - `count` integer, required
  - `next` string, uri, nullable
  - `previous` string, uri, nullable
  - `results` Item[], required
    - `created_ts` string, date-time, required — The timestamp in UTC when the item was created
    - `description` string — The description of the item.
    - `expense_account` string, nullable — The expense account for this item.
    - `external_id` string — External identifier for the item.
    - `id` string, required — The unique identifier of the item.
    - `is_active` boolean — Whether the item is active.
    - `is_tracked_inventory` boolean — Whether inventory is tracked for this item.
    - `item_units_of_measure` ItemUnitOfMeasureWrite[] — The units of measure for this item.
      - `conversion_factor` number, double, required — The conversion factor relative to the base unit.
      - `is_active` boolean — Whether this unit of measure is active.
      - `is_base` boolean — Whether this is the base unit of measure for the item.
      - `is_default_purchase` boolean — Whether this is the default unit for purchases.
      - `is_default_sales` boolean — Whether this is the default unit for sales.
      - `unit_cost` number, double, nullable — The unit cost for this unit of measure.
      - `unit_of_measure` string, required — The unique identifier of the unit of measure.
      - `unit_price` number, double, nullable — The unit price for this unit of measure.
    - `legacy_id` string, required — [Deprecated] The legacy identifier of the item.
    - `modified_ts` string, date-time, required — The timestamp in UTC when the item was last modified
    - `name` string, required — The name of the item.
    - `purchase_tax_rate` string, nullable — The tax rate applied when purchasing this item.
    - `quantity_on_hand` number, double, nullable, required — The current quantity on hand. Only relevant for tracked inventory items.
    - `revenue_account` string, nullable — The revenue account for this item.
    - `revenue_tax_rate` string, nullable — The tax rate applied when selling this item.
    - `sku` string — The SKU of the item.
    - `tax_authority` ApiV1DocumentItemTaxAuthority
      - `metadata` ApiV1DocumentItemTaxAuthorityMetadata
        - `default_exemption_reason` string, nullable
    - `unit_cost` number, double, nullable — The default unit cost of the item if no unit of measure is specified.
    - `unit_price` number, double, nullable — The default unit price of the item if no unit of measure is specified.

---

[API](https://skmtc.net/wafeq/apis/wafeq-public-api.md) · [All operations](https://skmtc.net/wafeq/apis/wafeq-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/wafeq/wafeq-public-api/revisions/36816b4fce7f/schema)