List Products
curl --request GET \
--url https://api.khaime.com/api/v1/products \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.khaime.com/api/v1/products"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.khaime.com/api/v1/products', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.khaime.com/api/v1/products",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.khaime.com/api/v1/products"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.khaime.com/api/v1/products")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.khaime.com/api/v1/products")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"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
}
}
}
Commerce API
List Products
Get all products for your business
GET
/
products
List Products
curl --request GET \
--url https://api.khaime.com/api/v1/products \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.khaime.com/api/v1/products"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.khaime.com/api/v1/products', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.khaime.com/api/v1/products",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.khaime.com/api/v1/products"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.khaime.com/api/v1/products")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.khaime.com/api/v1/products")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"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
}
}
}
List Products
Returns a paginated list of all published products for your business.Request
string
required
Your API key
Query Parameters
string
Currency code for price conversion (e.g., “USD”, “EUR”, “GBP”)
string
Country code for regional pricing (e.g., “US”, “GB”, “NG”)
string
default:"updatedAt"
Field to sort by
string
default:"DESC"
Sort order: “ASC” or “DESC”
integer
default:"1"
Page number
integer
default:"20"
Items per page (max 100)
string
Filter by product type: “physical_product”, “digital”, “live_event”, etc.
string
Search by product title or description
string
Comma-separated category IDs to filter by
Response
{
"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
}
}
}
Example
curl "https://api.khaime.com/api/v1/products?currency=USD&limit=10" \
-H "X-API-Key: pk_live_your_api_key"
⌘I
