Get a Specific Option Combination

GET /api/combinations/{combination_hash}

This endpoint allows you to retrieve detailed information about a specific product option combination by its unique hash identifier.

Request Example

GET /api/combinations/822274303
Success Response: If the request is successful, you'll receive HTTP/1.1 200 OK and a JSON response with the option combination details.

Response Format

{
  "combination_hash": "822274303",
  "product_id": "12",
  "product_code": "PRD-XY123-SM-BLU",
  "combination": {
    "3": "12",  // Option 3 (Size) = Variant 12 (Small)
    "4": "17"   // Option 4 (Color) = Variant 17 (Blue)
  },
  "amount": "10",
  "position": 0,
  "image_pairs": {
    "808": {
      "pair_id": "808",
      "image_id": "0",
      "detailed_id": "864",
      "position": "0",
      "detailed": {
        "object_id": "822274303",
        "object_type": "product_option",
        "image_path": "https://example.com/images/detailed/0/blue_small_pants.jpg",
        "alt": "Blue Small Pants",
        "image_x": "500",
        "image_y": "500"
      }
    }
  }
}

Response Fields

Field Type Description
combination_hash string The unique hash identifier for this option combination
product_id string The ID of the product this combination belongs to
product_code string The product code/SKU for this specific combination
combination object A mapping of option IDs to variant IDs that defines this combination
amount string The available stock quantity for this combination
position number The sorting position of this combination
image_pairs object Images associated with this specific combination
Tip: Option combinations represent specific configurations of product options (like "Small+Blue"). Each combination can have its own stock level, product code (SKU), and images. The combination_hash is a unique identifier generated from the set of selected option values.
Note: In the combination object, the keys represent option IDs, and the values represent the selected variant IDs for those options. For example, "3": "12" means that for option ID 3 (which might be "Size"), variant ID 12 (which might be "Small") is selected.