---
title: "قائمة الأصناف"
method: GET
path: "/v1/items"
tags: ["catalog"]
---

# قائمة الأصناف

`GET /v1/items`

لا يوجد فلتر افتراضي — تُعاد كل الأصناف ما لم تحدّد فلتراً.

## Query parameters

- `search` string
- `ids` string
- `category` string
- `brand` string
- `list` string
- `price_list` 1 | 2 | 3
- `warehouse` string
- `in_stock` boolean
- `min_price` number
- `max_price` number
- `active` boolean
- `visible` boolean
- `display_in_pos` boolean
- `updated_since` string
- `include` string
- `sort` 'name' | 'code' | 'price' | 'stock' | 'updated' | 'id'
- `order` 'asc' | 'desc'
- `page` integer
- `per_page` integer

## Response `200`

نجاح

- object
  - `success` boolean
  - `data` Item[]
    - `id` integer
    - `code` string, nullable
    - `name` string, nullable
    - `category` Ref
      - `id` integer, nullable
      - `name` string, nullable
    - `brand` Ref
      - `id` integer, nullable
      - `name` string, nullable
    - `currency` object
      - `id` integer, nullable
      - `code` string, nullable
      - `name` string, nullable
      - `decimals` integer
    - `sales_unit` object
      - `id` integer, nullable
      - `name` string, nullable
      - `abbreviation` string, nullable
      - `factor` number
    - `base_unit_id` integer, nullable
    - `price` number
    - `price_list` integer
    - `barcode` string, nullable
    - `stock` object
      - `warehouse_id` integer, nullable
      - `qty` number
      - `total_qty` number
      - `in_stock` boolean
      - `min_warning` integer, nullable
    - `flags` object
      - `is_service` boolean
      - `is_scale` boolean
      - `has_serial` boolean
      - `is_double` boolean
      - `display_in_pos` boolean
      - `visible` boolean
      - `active` boolean
      - `price_from_base_unit` boolean
    - `cost` object — يظهر فقط للمفاتيح التي تملك reports:read
      - `cost` number
      - `last_cost` number
      - `avg_cost` number
    - `units` ItemUnit[]
      - `unit_id` integer
      - `name` string, nullable
      - `abbreviation` string, nullable
      - `factor` number
      - `barcode` string, nullable
      - `prices` object
        - `1` number
        - `2` number
        - `3` number
    - `barcodes` object[]
      - `barcode` string
      - `unit_id` integer
    - `updated_at` string, date-time, nullable
  - `meta` Meta
    - `page` integer
    - `per_page` integer
    - `total` integer
    - `total_pages` integer
    - `has_more` boolean
  - `request_id` string, uuid

## Other responses

- `403` — صلاحية ناقصة أو اشتراك منتهٍ

---

[API](https://skmtc.dev/softpro/apis/softpro-api.md) · [All operations](https://skmtc.dev/softpro/apis/softpro-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/softpro/softpro-api/revisions/f30e0a849354/schema)