> ## Documentation Index
> Fetch the complete documentation index at: https://docs.khaime.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Products

> List all products for your merchant account.

# List Products

Retrieve all products associated with your merchant account. Supports filtering by product type and category.

## Query Parameters

| Parameter       | Type    | Description                                                                                                                                                                                                                                                                                                                           |
| --------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `category_id`   | integer | Filter by product category ID                                                                                                                                                                                                                                                                                                         |
| `category_slug` | string  | Filter by category slug or name. Comma-separated for multiple. Matches `slug` exactly OR `name` case-insensitively, so you can pass either `online-courses` or `Online Courses`. Unioned with `category_id` if both are provided. If the value matches no categories, the response is empty (the filter is **not** silently dropped). |
| `product_type`  | string  | Filter by type: `digital`, `physical`, `service`, `live_event`, `consultation`, `bundle`                                                                                                                                                                                                                                              |
| `limit`         | integer | Results per page (1-100, default 20)                                                                                                                                                                                                                                                                                                  |
| `offset`        | integer | Pagination offset (default 0)                                                                                                                                                                                                                                                                                                         |
| `sort_by`       | string  | Sort field (default `updatedAt`)                                                                                                                                                                                                                                                                                                      |
| `sort_order`    | string  | `ASC` or `DESC` (default `DESC`)                                                                                                                                                                                                                                                                                                      |

## Response

```json theme={null}
{
  "success": true,
  "data": {
    "products": [
      {
        "id": 3046,
        "title": "Premium Plan",
        "description": "Full access to all features",
        "price": 4999,
        "currency": "USD",
        "product_type": "digital",
        "status": "active"
      }
    ],
    "pagination": {
      "limit": 20,
      "offset": 0,
      "count": 1,
      "has_more": false
    }
  }
}
```

<RequestExample>
  ```bash cURL theme={null}
  curl https://api.khaime.com/api/v1/partner/products \
    -H "X-API-Key: pk_sandbox_your_key"
  ```

  ```bash Filter by category ID theme={null}
  curl "https://api.khaime.com/api/v1/partner/products?category_id=5" \
    -H "X-API-Key: pk_sandbox_your_key"
  ```

  ```bash Filter by category slug theme={null}
  curl "https://api.khaime.com/api/v1/partner/products?category_slug=online-courses" \
    -H "X-API-Key: pk_sandbox_your_key"
  ```

  ```bash Filter by category name theme={null}
  curl "https://api.khaime.com/api/v1/partner/products?category_slug=Online%20Courses" \
    -H "X-API-Key: pk_sandbox_your_key"
  ```

  ```bash Multiple categories theme={null}
  curl "https://api.khaime.com/api/v1/partner/products?category_slug=online-courses,workshops" \
    -H "X-API-Key: pk_sandbox_your_key"
  ```
</RequestExample>