/products/{code}

Fetch one product by SKU, including per location inventory and the platforms marketplace cache.

Catalogue scoping

Every API key is granted one or more catalogues, and a product is identified by code within a catalogue.

API key reaches	What to send	If you omit it
One catalogue	Nothing, it is inferred	Fine
More than one catalogue	`catalogue_id`	`400 catalogue_required`

A catalogue_id the key cannot reach returns 404 catalogue_not_found, never a cross tenant read.
The same code can exist in two catalogues you own, and those are two separate products.

inventory combines your own warehouse stock with marketplace distribution centre stock. A null DC value means Wherehouse has no stock feed for that location, which is not the same as zero.

Send your HTTP requests with an

Authorization

header that contains the word Basic followed by a space and a base64-encoded string username:password

Example:

Authorization: Basic *****************

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Success

application/json

The product.

Bodyapplication/json

Example

{
    "archived": false,
    "average_rating": null,
    "barcode": "0195949038543",
    "brand": "Apple",
    "catalogue": {
        "created_at": "2021-11-03T07:56:42.668Z",
        "id": 6,
        "name": "Apple Devices",
        "order_count": 10000,
        "product_count": 34,
        "uid": "demo-catalogue",
        "updated_at": "2025-02-20T11:04:42.308Z"
    },
    "category": "Smartphone",
    "code": "APL-IPH-34",
    "colour": "Blue Titanium",
    "cost_price": 19999,
    "created_at": "2026-07-28T09:12:04.118Z",
    "currency_code": "ZAR",
    "custom_attributes": null,
    "description": "6.1-inch Super Retina XDR display with ProMotion. A17 Pro chip. 48MP main camera with 5x telephoto. Titanium design.",
    "draft": false,
    "excerpt": "Titanium iPhone 15 Pro with the A17 Pro chip and a 48MP camera.",
    "fee_estimates": null,
    "height_cm": 0.83,
    "id": 1776790,
    "images": [
        {
            "src": "https://cdn.example.com/apl-iph-34/front.jpg"
        },
        {
            "src": "https://cdn.example.com/apl-iph-34/back.jpg"
        }
    ],
    "is_composite": false,
    "length_cm": 14.67,
    "main_image": "https://cdn.example.com/apl-iph-34/main.jpg",
    "material": "Titanium",
    "model_number": "A3101",
    "package_contents": "iPhone 15 Pro, USB-C cable, documentation",
    "parent_code": "APL-IPH-15PRO",
    "parent_title": "iPhone 15 Pro",
    "platforms": [
        {
            "admin_url": "https://seller.takealot.com/offers/PLID99887766",
            "connector_type": {
                "id": 1,
                "logo": "https://assets.wherehouse.co.za/connectors/logos/takealot.svg",
                "name": "Takealot",
                "uid": "takealot",
                "website": null
            },
            "created_at": "2026-07-28T10:41:12.004Z",
            "entity_id": "PLID99887766",
            "front_end_url": "https://www.takealot.com/iphone-15-pro/PLID99887766",
            "id": 884412,
            "last_seen_at": "2026-07-28T10:41:12.004Z",
            "list_price": 24999,
            "sell_price": 23499,
            "status": "live",
            "sub_type": null,
            "title": "Apple iPhone 15 Pro 256GB Blue Titanium",
            "updated_at": "2026-07-28T10:41:12.004Z"
        }
    ],
    "retail_price": 23499,
    "rich_description": "<p><strong>iPhone 15 Pro</strong> in Blue Titanium.</p><ul><li>A17 Pro chip</li><li>48MP main camera</li></ul>",
    "sale_price": null,
    "size": "256GB",
    "soh": 34,
    "tags": "smartphone,apple,5g",
    "title": "iPhone 15 Pro 256GB Blue Titanium",
    "total_reviews": null,
    "total_sales_count": null,
    "total_sales_count_30_days": null,
    "total_sales_value": null,
    "total_sales_value_30_days": null,
    "type": "variant",
    "updated_at": "2026-07-28T14:22:51.402Z",
    "variant_option_1_name": "Colour",
    "variant_option_1_value": "Blue Titanium",
    "variant_option_2_name": "Storage",
    "variant_option_2_value": "256GB",
    "variant_option_3_name": null,
    "variant_option_3_value": null,
    "weight_g": 187,
    "wholesale_price": 22499,
    "width_cm": 7.08,
    "inventory": {
        "our_warehouse": 34,
        "takealot_jhb_dc": 12,
        "takealot_cpt_dc": 5,
        "takealot_dbn_dc": null,
        "amazon_dc": 3
    }
}

🟠400Catalogue required

🟠401Unauthorized

🟠404Not found

🟠405Not allowed

🟠429Rate limited

Catalogue scoping#

Request

Request Code Samples

Responses

Catalogue scoping