Integration

API Product Status

Use this endpoint to validate the current status of a product before sending a purchase request.

Pre-purchase check

Main endpoint

GEThttps://bs.hydracidx.com/api/products/{product_id}/

This API is useful if you want to validate the status of a product before buying that product.

Authorization

Authentication uses the reseller static `url_token`.
Send the token in the `Authorization` header using the `Token` scheme.
The same token can be reused for every request until you rotate it.

Header example

Authorization: Token YOUR_STATIC_URL_TOKEN

Why use this endpoint

Check if the product is still available before creating a purchase.
Confirm current stock, pricing tiers, warranty, and download information.
Use it when your store needs a final validation step right before checkout confirmation.
Do not use this API to directly serve product details to store users. It is only intended for final validation, and abusive API usage will be blocked.

Request parameters

This endpoint uses a single parameter directly in the request path.

URL path

product_id

uuid

The public product identifier for the exact product you want to validate.

Use the same public UUID shown in the API Products section.
Do not send internal numeric IDs.
The endpoint returns 404 if the product is not currently available.

Example: 3d00a9a2-df70-4d60-9dd3-8f2dc188646a

Request examples

Route example

cURL

curl --request GET \
  --url "https://hydracidx.com/api/products/3d00a9a2-df70-4d60-9dd3-8f2dc188646a/" \
  --header "Authorization: Token YOUR_STATIC_URL_TOKEN"

Example response

Current product data

{
  "product_id": "3d00a9a2-df70-4d60-9dd3-8f2dc188646a",
  "name": "Office 2024 HB Retail Phone",
  "key_desc": "Office24_HomeBusiness2024R_Retail",
  "stock": 1,
  "unit_price": "10.00",
  "wholesale_price": "7.99",
  "pricing_tiers": {
    "qty_1_4": "10.00",
    "qty_5_9": "9.33",
    "qty_10_19": "9.00",
    "qty_20_plus": "7.99"
  },
  "warranty_days": 1,
  "acts_remaining": null,
  "download_url": "",
  "duration_days": null
}

Returned fields

product_id identifies the product.
stock, unit_price, wholesale_price, and pricing_tiers show the current commercial status.
acts_remaining is only relevant for MAK & LSTC products.
duration_days is only relevant for products with a limited duration like Antivirus subscriptions.

Complete catalog

If you want to see the full list of products, go to the API Products page.
That page is consulted manually and not through this product status API.
Use API Product Status only when you need to validate one specific product before purchase.

Menu