Add-Product Search (Create-Order)
The slim product search that powers the admin Create Order screen's "Add Product" modal. It returns a compact row per product so an operator can quickly find and pick a product to add to a draft order.
This is not the product listing
For the full admin product listing — every column plus all the Channel / Name / SKU / Attribute Family / Price / ID / Status / Type filters — use List Products (GET /api/admin/catalog/products). This page documents only the Create-Order search tool.
Results come back in the { data, meta } envelope used by every admin collection.
Endpoint
| Endpoint | Method |
|---|---|
/api/admin/products | GET |
How it differs from /api/shop/products
| Shop | Admin | |
|---|---|---|
| Default status filter | Only status = 1 and visible_individually = 1 | No filter — all statuses returned |
| Booking products | Hidden by shop visibility rules | Listed (blocked only when added to admin draft cart) |
| Row payload | Full storefront fields (variants, prices, special prices, etc.) | Slim picker shape (9 fields) |
| Pagination response | Header-based (X-Total-Count, X-Page, ...) | Body envelope ({ data, meta }) |
| Authentication | Storefront key + optional customer Sanctum | Admin Sanctum token |
Query Parameters
| Parameter | Type | Description |
|---|---|---|
page | integer | Page number (default 1) |
per_page | integer | Items per page (default 30, cap 50) |
query | string | Free-text — matches SKU OR product name (partial) |
sku | string | Exact SKU |
type | string | simple, configurable, bundle, downloadable, grouped, virtual, booking |
status | integer | 0 (disabled) or 1 (enabled) — omit to get both |
categoryId | integer | Filter by category ID |
channel | string | Channel code for value resolution |
locale | string | Locale code for value resolution |
sort | string | id, sku, created_at, updated_at |
order | string | asc or desc (default desc) |
Row Shape
| Field | Type | Notes |
|---|---|---|
id | integer | Product ID |
sku | string | SKU |
type | string | Product type |
name | string|null | Resolved via locale/channel if provided |
status | integer|null | 1 enabled / 0 disabled |
price | number|null | Minimal price for the resolved customer group |
formattedPrice | string|null | Locale-formatted price |
baseImageUrl | string|null | Medium-cache image URL, falls back to original |
isSaleable | boolean | Type-instance saleability check |
Booking Products
Booking products are returned by this endpoint so admin can find and review them. They are blocked at admin draft-cart add-to-cart time (POST /api/admin/carts/{id}/items) with HTTP 400 and the message "Booking products cannot be added to an admin draft order." This matches the Bagisto monolith — the admin Create-Order UI does not ship a booking partial either.