Get Category Products

This endpoint fetches all VAS products for a specific category. It is useful for displaying products dynamically in your application based on the selected category.

---

Path: POST BASE_URL/products/category/{categoryId}

Authorization: Bearer <YOUR_BEARER_TOKEN>

---

Path Parameters

Parameter	Type	Description
categoryId	number	Unique ID of the category for which to fetch products

⚠️ The categoryId can be obtained from the GET /products/categories endpoint.

---

Description

• Returns all products under a specific category.
• Each product includes pricing, brand, availability, and purchase constraints.
• Supports both fixed-amount and variable-amount products.

---

Response Structure

[
    {
        "name": "Weekly YouTube 1GB R19",
        "shortName": "Weekly YouTube 1GB R19",
        "code": "DAT-CLC-028",
        "minAmount": 19.00,
        "maxAmount": 19.00,
        "imageUrl": "https://pagamio-assets.ams3.digitaloceanspaces.com/vas-uat/1757943353725-1757943350465_3jshf6.png",
        "status": 1,
        "id": 21450,
        "categoryId": 1002,
        "categoryName": "Data",
        "brandId": 2850,
        "brandName": "Cellc",
        "fixedAmount": true,
        "pinLess": true
    },
    {
        "name": "7GB (1GB X 7 days) EveryDayGigs (1 Week) MTN Cellular Data Pinless",
        "shortName": "7GB EveryDayGigs Weekly",
        "code": "DAT-MTN-037",
        "minAmount": 99.00,
        "maxAmount": 99.00,
        "imageUrl": "https://portal.pagamio.com/api/v1/media/download/PG_CORNERSMTN.png",
        "status": 1,
        "id": 13400,
        "categoryId": 1002,
        "categoryName": "Data",
        "brandId": 1007,
        "brandName": "MTN",
        "fixedAmount": false,
        "pinLess": false
    }
]

---

Fields Explained

Field	Type	Description
name	string	Full name of the product
shortName	string	Short or display-friendly name
code	string	Unique product code used for purchases
minAmount	number	Minimum allowable purchase amount
maxAmount	number	Maximum allowable purchase amount
imageUrl	string	URL of the product image
status	int	Product availability (1 = active, 0 = inactive)
id	number	Product ID
categoryId	number	ID of the category this product belongs to
categoryName	string	Name of the category
brandId	number	Brand ID of the product
brandName	string	Brand name of the product
fixedAmount	boolean	Indicates if the product amount is fixed (true) or variable (false)
pinLess	boolean	Indicates if the product is pinless (true) or requires a PIN (false)

---

Notes

1. Use this endpoint to dynamically display products when a user selects a category.
2. Combine with /products/categories/{categoryId}/fields to know which fields are required for purchase.
3. Ensure Authorization Bearer token is included in all requests.

---

Last updated: October 2025