Get Products
Retrieve available products with tier-specific pricing, filterable by category.
Returns the catalog of all available products assigned to your reseller account. The prices returned are already resolved according to your assigned tier (Bronze, Silver, or Gold) across all assigned catalogs.
Endpoint
Request Headers
Headers
| Parameter | Type | Required | Description |
|---|---|---|---|
X-Api-Key | String | Yes | Your API key. See Authentication. |
Query Parameters
Query Params
| Parameter | Type | Required | Description |
|---|---|---|---|
category_slug | String | No | Filter by game slug (e.g., "mobile-legends"). Lowercase kebab-case; anything else returns 400 VALIDATION_ERROR. Get slugs from GET /api/v1/categories. An unknown or inactive slug returns an empty list, not an error. |
page | Number | No | Page number (1-based, default: 1). |
limit | Number | No | Items per page (1–100, default: 50). |
Response
{
"success": true,
"data": {
"products": [
{
"code": "MLBB-86",
"name": "Mobile Legends 86 Diamonds",
"category": "Mobile Legends: Bang Bang",
"category_slug": "mobile-legends",
"price": 725,
"status": "active"
},
{
"code": "MLBB-172",
"name": "Mobile Legends 172 Diamonds",
"category": "Mobile Legends: Bang Bang",
"category_slug": "mobile-legends",
"price": 1435,
"status": "inactive"
},
{
"code": "FF-70",
"name": "Free Fire 70 Diamonds",
"category": "Free Fire",
"category_slug": "free-fire",
"price": 290,
"status": "active"
}
]
},
"meta": {
"total": 142,
"page": 1,
"limit": 50,
"total_pages": 3,
"has_more": true
}
}Field Behavior
Response Fields
| Parameter | Required | Description |
|---|---|---|
code | No | The product_code you send to POST /api/v1/order. Stable — use it as your primary key. |
category_slug | No | Stable game key. Matches slug in GET /api/v1/categories and is the value to pass as ?category_slug=. Use this to join the two endpoints. |
category | No | Game DISPLAY name. Can be renamed by an admin at any time — never key or filter on it. |
price | No | Your tier price in PHP, already resolved. This is what will be deducted. |
status | No | "active" = orderable right now. "inactive" = listed but NOT currently fulfillable — do not offer it for sale. |
Always honour `status` when you sync
status is computed per request from live availability: it turns inactive when the product
can no longer be delivered — for example when the upstream provider delists the SKU.
A product can flip to inactive at any time with no warning.
When you sync our catalog, mark anything that is not status: "active" as unavailable in
your own system. Ordering an inactive product will fail with
failure_code: PRODUCT_UNAVAILABLE and be refunded — a wasted round trip for you and your
customer.
Products a store admin disables, and games that are deactivated entirely, are removed from
this response rather than marked inactive. So both checks matter: a code that has vanished
from the list is as unavailable as one marked inactive.
Caching
Responses are Cache-Control: private — they are specific to your API key, because prices
resolve against your tier and the set is scoped to the catalogs assigned to you. Do not place
them in a shared or CDN cache. Re-sync at least every few minutes if you mirror our catalog.
Example cURL
# Get all products (paginated)
curl -s "https://[kaybs-domain]/api/v1/products?page=1&limit=10" \
-H "X-Api-Key: ${KAYBS_API_KEY}"
# Filter by category
curl -s "https://[kaybs-domain]/api/v1/products?category_slug=mobile-legends&page=1&limit=20" \
-H "X-Api-Key: ${KAYBS_API_KEY}"
Typical Integration Flow
Recommended Flow
- Call
GET /categoriesto get the list of games and theirformfields. - Call
GET /products?category_slug=mobile-legendsto get available denominations and prices. - Display the
formfields from step 1 and the products from step 2 to the end-user. - When the user selects a product and fills in the form, call
POST /order.
Caching
Performance
Responses carry Cache-Control: private, max-age=30, must-revalidate. Caching a response for
up to 30 seconds in your own server is safe; never put it in a shared or CDN cache.