> ## 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

> Get all products for your business

# List Products

Returns a paginated list of all published products for your business.

## Request

<ParamField header="X-API-Key" type="string" required>
  Your API key
</ParamField>

### Query Parameters

<ParamField query="currency" type="string">
  Currency code for price conversion (e.g., "USD", "EUR", "GBP")
</ParamField>

<ParamField query="country" type="string">
  Country code for regional pricing (e.g., "US", "GB", "NG")
</ParamField>

<ParamField query="sort_by" type="string" default="updatedAt">
  Field to sort by
</ParamField>

<ParamField query="sort_order" type="string" default="DESC">
  Sort order: "ASC" or "DESC"
</ParamField>

<ParamField query="page" type="integer" default="1">
  Page number
</ParamField>

<ParamField query="limit" type="integer" default="20">
  Items per page (max 100)
</ParamField>

<ParamField query="type" type="string">
  Filter by product type: "physical\_product", "digital", "live\_event", etc.
</ParamField>

<ParamField query="search" type="string">
  Search by product title or description
</ParamField>

<ParamField query="category_ids" type="string">
  Comma-separated category IDs to filter by
</ParamField>

## Response

<ResponseExample>
  ```json theme={null}
  {
    "status": true,
    "message": "Products retrieved successfully",
    "data": {
      "products": [
        {
          "id": 12345,
          "title": "Premium T-Shirt",
          "slug": "premium-t-shirt",
          "description": "High-quality cotton t-shirt",
          "type": "physical_product",
          "price": 2999,
          "currency": "USD",
          "is_published": true,
          "images": [
            {
              "url": "https://cdn.khaime.com/...",
              "alt": "Premium T-Shirt"
            }
          ],
          "variations": [...],
          "currency_conversion_details": {
            "currency": "USD",
            "source_currency": "USD",
            "exchange_rate": 1
          }
        }
      ],
      "pagination": {
        "page": 1,
        "limit": 20,
        "total": 45
      }
    }
  }
  ```
</ResponseExample>

## Example

```bash theme={null}
curl "https://api.khaime.com/api/v1/products?currency=USD&limit=10" \
  -H "X-API-Key: pk_live_your_api_key"
```