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

GET/api/v1/products

Request Headers

Headers

ParameterTypeRequiredDescription
X-Api-KeyStringYesYour API key. See Authentication.

Query Parameters

Query Params

ParameterTypeRequiredDescription
category_slugStringNoFilter 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.
pageNumberNoPage number (1-based, default: 1).
limitNumberNoItems per page (1–100, default: 50).

Response

200OK
json
{
"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

ParameterRequiredDescription
codeNoThe product_code you send to POST /api/v1/order. Stable — use it as your primary key.
category_slugNoStable 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.
categoryNoGame DISPLAY name. Can be renamed by an admin at any time — never key or filter on it.
priceNoYour tier price in PHP, already resolved. This is what will be deducted.
statusNo"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

  1. Call GET /categories to get the list of games and their form fields.
  2. Call GET /products?category_slug=mobile-legends to get available denominations and prices.
  3. Display the form fields from step 1 and the products from step 2 to the end-user.
  4. 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.

PreviousCategoriesNextCreate Order