List Items

GET

https://api.techrar.com/inventory/v1/merchant/items/

This endpoint allows you to list all available items related to your store.

Permission

can_read_item - Items read only

Filters

You can filter items with almost all the fields in the item e.g. type, service_type, ..etc

Light Objects

In most list endpoints, the returned object will be light.
Use the details endpoint to get a detailed object

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Query Params

Header Params

Responses

🟢200Success

application/json

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.techrar.com/inventory/v1/merchant/items/?page=1&page_size=5' \
--header 'app-id: 4' \
--header 'Authorization: Bearer <token>'

Response Example

{
    "count": 30,
    "next": "http://localhost:8000/inventory/v1/merchant/items/?page=2&page_size=5",
    "previous": null,
    "results": [
        {
            "id": 58,
            "custom_fields": null,
            "images": [],
            "discounts": [],
            "categories": [
                {
                    "id": 6,
                    "custom_fields": null,
                    "app_id": 4,
                    "created_at": "2025-01-28T11:25:50.211010+03:00",
                    "modified_at": "2025-01-28T11:25:50.211038+03:00",
                    "is_deleted": false,
                    "deleted_at": null,
                    "ordering": 0,
                    "name_en": "Classes",
                    "name_ar": "Classes",
                    "is_active": true
                }
            ],
            "modifiers": [],
            "variants": [],
            "varies_on": null,
            "off_days": [],
            "off_dates": [],
            "bundle_categories": [],
            "plan_config": null,
            "app_id": 4,
            "created_at": "2025-01-28T11:27:04.933371+03:00",
            "modified_at": "2025-02-06T17:51:22.480611+03:00",
            "is_deleted": false,
            "deleted_at": null,
            "ordering": 0,
            "type": "booking",
            "service_type": "access",
            "sku": "the_first_class",
            "price": 0,
            "name_en": "The first class",
            "name_ar": "The first class",
            "description_en": "",
            "description_ar": "",
            "is_main_variant": true,
            "variant_title_en": null,
            "variant_title_ar": null,
            "is_bundle_item_only": false,
            "branch_id": null,
            "city_id": null,
            "handler_id": null,
            "limited_qty": false,
            "qty": 10,
            "is_scheduled": true,
            "is_plan_only": false,
            "is_plan_enabled": false,
            "is_active": true,
            "served_from_date": null,
            "served_to_date": null,
            "served_from_time": "06:00:00",
            "served_to_time": "07:00:00",
            "gender": "male",
            "allow_checkin_everywhere": false,
            "allow_preferred_date": false,
            "allow_preferred_time": false
        },
        {
            "id": 56,
            "custom_fields": null,
            "images": [],
            "discounts": [
                {
                    "id": 13,
                    "custom_fields": null,
                    "app_id": null,
                    "created_at": "2025-01-26T16:39:31.233296+03:00",
                    "modified_at": "2025-01-26T16:39:31.233301+03:00",
                    "is_deleted": false,
                    "deleted_at": null,
                    "ordering": 0,
                    "type": "flat",
                    "value": 1,
                    "is_active": true,
                    "active_from": null,
                    "active_to": null,
                    "item": 56
                }
            ],
            "categories": [
                {
                    "id": 1,
                    "custom_fields": null,
                    "app_id": 4,
                    "created_at": "2025-01-06T11:06:05.000352+03:00",
                    "modified_at": "2025-01-06T11:06:05.000356+03:00",
                    "is_deleted": false,
                    "deleted_at": null,
                    "ordering": 0,
                    "name_en": "Musk Products",
                    "name_ar": "منتجات المسك",
                    "is_active": true
                }
            ],
            "modifiers": [],
            "variants": [],
            "varies_on": null,
            "off_days": [],
            "off_dates": [],
            "bundle_categories": [],
            "plan_config": null,
            "app_id": 4,
            "created_at": "2025-01-26T11:27:18.062106+03:00",
            "modified_at": "2025-01-26T16:39:31.218719+03:00",
            "is_deleted": false,
            "deleted_at": null,
            "ordering": 0,
            "type": "product",
            "service_type": "delivery",
            "sku": "the",
            "price": 100,
            "name_en": "The new product",
            "name_ar": "The new product",
            "description_en": "",
            "description_ar": "",
            "is_main_variant": true,
            "variant_title_en": null,
            "variant_title_ar": null,
            "is_bundle_item_only": false,
            "branch_id": null,
            "city_id": null,
            "handler_id": null,
            "limited_qty": true,
            "qty": 10,
            "is_scheduled": false,
            "is_plan_only": false,
            "is_plan_enabled": false,
            "is_active": true,
            "served_from_date": null,
            "served_to_date": null,
            "served_from_time": null,
            "served_to_time": null,
            "gender": null,
            "allow_checkin_everywhere": false,
            "allow_preferred_date": false,
            "allow_preferred_time": false
        },
        {
            "id": 54,
            "custom_fields": null,
            "images": [],
            "discounts": [],
            "categories": [
                {
                    "id": 1,
                    "custom_fields": null,
                    "app_id": 4,
                    "created_at": "2025-01-06T11:06:05.000352+03:00",
                    "modified_at": "2025-01-06T11:06:05.000356+03:00",
                    "is_deleted": false,
                    "deleted_at": null,
                    "ordering": 0,
                    "name_en": "Musk Products",
                    "name_ar": "منتجات المسك",
                    "is_active": true
                }
            ],
            "modifiers": [],
            "variants": [],
            "varies_on": null,
            "off_days": [],
            "off_dates": [],
            "bundle_categories": [],
            "plan_config": null,
            "app_id": 4,
            "created_at": "2025-01-26T11:25:30.015005+03:00",
            "modified_at": "2025-01-26T15:51:53.342658+03:00",
            "is_deleted": false,
            "deleted_at": null,
            "ordering": 0,
            "type": "product",
            "service_type": "delivery",
            "sku": "new_prod_skuuuu",
            "price": 100,
            "name_en": "The new product",
            "name_ar": "The new product",
            "description_en": "",
            "description_ar": "",
            "is_main_variant": true,
            "variant_title_en": null,
            "variant_title_ar": null,
            "is_bundle_item_only": false,
            "branch_id": null,
            "city_id": null,
            "handler_id": null,
            "limited_qty": true,
            "qty": 10,
            "is_scheduled": false,
            "is_plan_only": false,
            "is_plan_enabled": false,
            "is_active": true,
            "served_from_date": null,
            "served_to_date": null,
            "served_from_time": null,
            "served_to_time": null,
            "gender": null,
            "allow_checkin_everywhere": false,
            "allow_preferred_date": false,
            "allow_preferred_time": false
        },
        {
            "id": 53,
            "custom_fields": null,
            "images": [],
            "discounts": [],
            "categories": [
                {
                    "id": 5,
                    "custom_fields": null,
                    "app_id": 4,
                    "created_at": "2025-01-18T22:50:23.968091+03:00",
                    "modified_at": "2025-01-18T22:50:23.968129+03:00",
                    "is_deleted": false,
                    "deleted_at": null,
                    "ordering": 0,
                    "name_en": "Donations",
                    "name_ar": "Donations",
                    "is_active": true
                }
            ],
            "modifiers": [],
            "variants": [],
            "varies_on": null,
            "off_days": [],
            "off_dates": [],
            "bundle_categories": [],
            "plan_config": null,
            "app_id": 4,
            "created_at": "2025-01-18T22:50:50.063470+03:00",
            "modified_at": "2025-01-18T22:50:50.063501+03:00",
            "is_deleted": false,
            "deleted_at": null,
            "ordering": 0,
            "type": "donation",
            "service_type": "digital",
            "sku": "donation",
            "price": 0,
            "name_en": "Donation",
            "name_ar": "Donation",
            "description_en": "",
            "description_ar": "",
            "is_main_variant": true,
            "variant_title_en": null,
            "variant_title_ar": null,
            "is_bundle_item_only": false,
            "branch_id": null,
            "city_id": null,
            "handler_id": null,
            "limited_qty": false,
            "qty": 10,
            "is_scheduled": false,
            "is_plan_only": false,
            "is_plan_enabled": false,
            "is_active": true,
            "served_from_date": null,
            "served_to_date": null,
            "served_from_time": null,
            "served_to_time": null,
            "gender": null,
            "allow_checkin_everywhere": false,
            "allow_preferred_date": false,
            "allow_preferred_time": false
        },
        {
            "id": 52,
            "custom_fields": null,
            "images": [],
            "discounts": [],
            "categories": [],
            "modifiers": [],
            "variants": [],
            "varies_on": null,
            "off_days": [],
            "off_dates": [],
            "bundle_categories": [],
            "plan_config": null,
            "app_id": 4,
            "created_at": "2025-01-18T18:52:20.468252+03:00",
            "modified_at": "2025-01-18T18:52:20.468254+03:00",
            "is_deleted": false,
            "deleted_at": null,
            "ordering": 0,
            "type": "service",
            "service_type": "digital",
            "sku": "techrar_apps",
            "price": 0,
            "name_en": "Techrar Apps",
            "name_ar": "تطبيقات تكار",
            "description_en": null,
            "description_ar": null,
            "is_main_variant": true,
            "variant_title_en": null,
            "variant_title_ar": null,
            "is_bundle_item_only": false,
            "branch_id": null,
            "city_id": null,
            "handler_id": null,
            "limited_qty": true,
            "qty": 10,
            "is_scheduled": false,
            "is_plan_only": false,
            "is_plan_enabled": false,
            "is_active": true,
            "served_from_date": null,
            "served_to_date": null,
            "served_from_time": null,
            "served_to_time": null,
            "gender": null,
            "allow_checkin_everywhere": false,
            "allow_preferred_date": false,
            "allow_preferred_time": false
        }
    ]
}

Modified at 2025-06-17 08:18:15

Update Item Config

Item Details