Fetch All Products

Retrieve a nested list of all active categories and their corresponding products.

Endpoint Features

The Fetch All Products endpoint allows you to programmatically fetch all currently active categories and the products inside them.

Dynamic Pricing Engine

Note: The API intelligently determines the customer's VIP Rank (Bronze, Silver, Gold, or Platinum) based on the provided API Key. The price field returned for every single product is already calculated exactly to match the user's specific tier discount!

Authentication

Requires Authorization header with a Bearer API token.

Response Attributes (Categories)

FieldTypeDescription
idstringThe UUID of the category.
namestringDisplay name of the category (e.g., VPNs, Accounts).
productsarray[object]Array containing all the active products under this category.

Response Attributes (Products inside Category)

FieldTypeDescription
uuidstringThe unique identifier of the product. Required for making a purchase.
typestringIs normal or service.
pricenumberThe final price the current API Key holder will pay.
stocknumberCurrent available quantity.
telegramDetailsobjectOptionally includes special Telegram Bot integration data if applicable.

Interactive Testing

Ensure your API key is correctly configured in the top bar, then press Try It.

GET
https://api.hsmail.shop/v1/products
Headers:Authorization: (Not Set - Set in Topbar)

Request Snippets

curl -X GET https://api.hsmail.shop/v1/products \
  -H "Authorization: Bearer YOUR_API_KEY"