API Reference ยท v1
Products
GET
/Catalog/ProductsList products
Returns products grouped with their variants, including brand, category hierarchy, images, MSRP and dealer net price. Supports filtering by brand, category, SKU, or product group ID. Every listed variant carries canBuy. By default only the variants the dealer can buy are listed; pass showCanBuyFalse=true to also list the others (canBuy=false, price and stock 0).
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| brand | query | string | null | Optional | Filter by brand code |
| catCode | query | string | null | Optional | Filter by category code |
| sku | query | string | null | Optional | Filter by specific SKU |
| productId | query | string | null | Optional | Filter by product group ID |
| pageStartIndex | query | integer | Optional | Zero-based start index(default: 0) |
| pageSize | query | integer | Optional | Number of records to return(default: 100) |
| language | header | string | null | Optional | (default: en) |
Request
GET
/Catalog/ProductsGET https://api.ltpdealer.com/v1/Catalog/Products
Authorization: ApiKey <prefix>.<secret>
language: enResponse
200Successful Response
{
"products": [
{
"attribute_group": "",
"brand_id": "WTB",
"brand_name": "WTB",
"brand_url": "www.wtb.com",
"category": "TIRES",
"category_group": "19",
"category_group_id": "19",
"category_id": "TIRES",
"description": "<detail_desc><p>Usage: Urban / Pavement</p><p>It’s all in the name, ThickSlick. A burly casing designed to withstand the roughest urban conditions paired with a slick tread design that provides the bite you need in the concrete jungle with impeccable style.</p><ul><li>Slicker than slick: No-nonsense slick design provides optimal traction on smooth concrete and rough city streets</li><li>This rubber casing provides puncture resistance from urban debris</li><li>DNA Rubber</li><li>30 TPI</li></ul></detail_desc>",
"id": "12973G",
"images": [
{
"primary": true,
"src": "https://ltpdealer.com/zims/norcoper/sha1-93054f62e382cc651b9c504a3af1821b9184086f.jpg"
}
],
"subcategory": "700C TIRES/622 ISO",
"subcategory_id": "700C TIRE 622",
"title": "THICKSLICK 700C URBAN COMP TIRE - BLACK",
"variants": [
{
"attributes": {
"Bead": "Wire",
"Compound": "DNA",
"Diameter": "700c",
"Intended Use": "Commute-Trekking",
"Series": "Thickslick",
"Sidewall Colour": "Black",
"Size": "25 mm",
"Tread Colour": "Black",
"Type": "Clincher"
},
"availability": "backorder",
"canBuy": true,
"currency": "CAD",
"dealer_price": "26.50",
"inventory_quantity": 0,
"msrp_price": "49.95",
"parent_id": "12973G",
"sku": "163006-01",
"title": "WTB T-SLICK 700x25W COMP ENDUR",
"upc": "714401106109"
},
{
"attributes": {
"Bead": "Wire",
"Compound": "DNA",
"Diameter": "700c",
"Intended Use": "Commute-Trekking",
"Series": "Thickslick",
"Sidewall Colour": "Black",
"Size": "28 mm",
"Tread Colour": "Black",
"Type": "Clincher"
},
"availability": "backorder",
"canBuy": true,
"currency": "CAD",
"dealer_price": "26.50",
"inventory_quantity": 0,
"msrp_price": "49.95",
"parent_id": "12973G",
"sku": "163006-02",
"title": "WTB T-SLICK 700x28W COMP ENDUR",
"upc": "714401106116"
}
]
}
]
}| Field | Type | Description |
|---|---|---|
| products | array<ProductItem> |
422Validation Error
{
"detail": [
{
"loc": [
"string"
],
"msg": "Message",
"type": "Error Type"
}
]
}| Field | Type | Description |
|---|---|---|
| detail | array<ValidationError> |
Code Examples
curl -X GET "https://api.ltpdealer.com/v1/Catalog/Products?pageStartIndex=0&pageSize=100" \
-H "Authorization: ApiKey <prefix>.<secret>" \
-H "language: en"GET
/Catalog/Products/InventoryGet product inventory
Returns warehouse inventory quantities per SKU, broken down by warehouse, restricted to the SKUs the authenticated dealer is entitled to. Optionally filter by a comma-separated list of SKUs.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| skus | query | string | null | Optional | Comma-separated list of SKUs |
| pageStartIndex | query | integer | Optional | Zero-based start index(default: 0) |
| pageSize | query | integer | Optional | Number of records to return(default: 100) |
| language | header | string | null | Optional | (default: en) |
Request
GET
/Catalog/Products/InventoryGET https://api.ltpdealer.com/v1/Catalog/Products/Inventory
Authorization: ApiKey <prefix>.<secret>
language: enResponse
200Successful Response
{
"inventory": [
{
"availability": "backorder",
"inventory_quantity": 0,
"next_eta_date": "",
"sku": "02915800-008",
"warehouses": [
{
"id": "V",
"name": "Vancouver",
"next_eta_date": "",
"quantity_available": 0,
"soldout": true
},
{
"id": "O",
"name": "Toronto",
"next_eta_date": "",
"quantity_available": 0,
"soldout": false
},
{
"id": "U",
"name": "United States",
"next_eta_date": "",
"quantity_available": 0,
"soldout": true
}
]
}
]
}| Field | Type | Description |
|---|---|---|
| inventory | array<InventoryItem> |
422Validation Error
{
"detail": [
{
"loc": [
"string"
],
"msg": "Message",
"type": "Error Type"
}
]
}| Field | Type | Description |
|---|---|---|
| detail | array<ValidationError> |
Code Examples
curl -X GET "https://api.ltpdealer.com/v1/Catalog/Products/Inventory?pageStartIndex=0&pageSize=100" \
-H "Authorization: ApiKey <prefix>.<secret>" \
-H "language: en"GET
/Catalog/Products/ImagesGet product images
Returns image URLs grouped by product, restricted to the products the authenticated dealer is entitled to. Optionally filter by a single product ID (group_id).
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| productId | query | string | null | Optional | Filter by product group ID |
| pageStartIndex | query | integer | Optional | Zero-based start index(default: 0) |
| pageSize | query | integer | Optional | Number of records to return(default: 100) |
| language | header | string | null | Optional | (default: en) |
Request
GET
/Catalog/Products/ImagesGET https://api.ltpdealer.com/v1/Catalog/Products/Images
Authorization: ApiKey <prefix>.<secret>
language: enResponse
200Successful Response
{
"images": [
{
"product_id": "ABC123",
"images": [
{
"src": "https://cdn.ltpdealer.com/images/example.jpg",
"primary": false,
"position": 0
}
]
}
]
}| Field | Type | Description |
|---|---|---|
| images | array<ProductImages> |
422Validation Error
{
"detail": [
{
"loc": [
"string"
],
"msg": "Message",
"type": "Error Type"
}
]
}| Field | Type | Description |
|---|---|---|
| detail | array<ValidationError> |
Code Examples
curl -X GET "https://api.ltpdealer.com/v1/Catalog/Products/Images?pageStartIndex=0&pageSize=100" \
-H "Authorization: ApiKey <prefix>.<secret>" \
-H "language: en"Authentication
API Key required
Response Codes
200422