| Table of Contents |
|---|
Request example
| Code Block |
|---|
curl --location 'https://devdemo.tireconnect.ca/apiv2.php/tire/search/costcoSearch?key=771c4645c853baab29f6551c362d4a33' \
--data-urlencode 'location_id=34027' \
--data-urlencode 'part_numbers%5B%5D=000063' \
--data-urlencode 'part_numbers%5B1%5D=001131' |
Request parameters
...
Parameter
| Table of Contents |
|---|
Request example
| Code Block |
|---|
curl --location 'https://devdemo.tireconnect.ca/api/v2/tire/search/costcoSearch?key=19a41bee2c2e09d279226ab754166d2a' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'location_id=12825' \
--data-urlencode 'quantity=4' \
--data-urlencode 'part_numbers%5B0%5D=477761' \
--data-urlencode 'part_numbers%5B1%5D=1218573' |
Request parameters
Parameter | Value |
|---|---|
key string | API key Required |
location_id integer | Location id Required |
part_numbers[] array | Array of part numbers Required |
quantity integer | Desired Quantity. Used to determine suppliers and their branches with enough quantity Required |
Response example
| Code Block | ||
|---|---|---|
| ||
{
"notice": "Success",
"data": {
"nb_results": 2,
"tires": [
{
"part_number": "000063",
"brand": "Bridgestone",
"suppliers": [
{
"id": "QnJpZGdlc3RvbmV8fDAwMDA2M3x8YnJpZGdlc3RvbmVpd3Nsd3N8fDM0MDI3fHxC",
"price": null,
"quantity": 10799,
"supplier": "bridgestoneiwslws",
"stock": [
{
"branch": "D009",
"id": "D009",
"quantity": 1906,
"name": "D009 Ontario DC",
"branch_type": null,
"delivery_date_time": null,
"cutoff": null
},
{
"branch": "D011",
"id": "D011",
"quantity": 1370,
"name": "D011 DFW DC",
"branch_type": null,
"delivery_date_time": null,
"cutoff": null
},
{
"branch": "D010",
"id": "D010",
"quantity": 2428,
"name": "D010 Portland DC",
"branch_type": null,
"delivery_date_time": null,
"cutoff": null
},
{
"branch": "D002",
"id": "D002",
"quantity": 2125,
"name": "D002 Chicago DC",
"branch_type": null,
"delivery_date_time": null,
"cutoff": null
},
{
"branch": "D012",
"id": "D012",
"quantity": 1317,
"name": "D012 Lebanon DC",
"branch_type": null,
"delivery_date_time": null,
"cutoff": null
},
{
"branch": "D014",
"id": "D014",
"quantity": 1653,
"name": "D014 Jacksonville DC",
"branch_type": null,
"delivery_date_time": null,
"cutoff": null
}
],
"delivery_date_time": {
"date": "2023-11-22",
"time": null,
"timezone": null,
"notes": null
}
},
{
"id": "QnJpZGdlc3RvbmV8fDAwMDA2M3x8Z3JvdXBldG91Y2hldGV8fDM0MDI3fHxC",
"price": null,
"quantity": 3,
"supplier": "groupetouchete",
"stock": [
{
"branch": "Default",
"id": "Default",
"quantity": 3,
"name": "Default",
"branch_type": null,
"delivery_date_time": null,
"cutoff": null
}
],
"delivery_date_time": {
"date": "2023-11-23",
"time": null,
"timezone": null,
"notes": null
}
},
{
"id": "QnJpZGdlc3RvbmV8fDAwMDA2M3x8bnRkfHwzNDAyN3x8Qg==",
"price": null,
"quantity": 25,
"supplier": "ntd",
"stock": [
{
"branch": "local",
"id": "local",
"quantity": 8,
"name": "Local - Same-day (if ordered before cut off time)",
"branch_type": "primary",
"delivery_date_time": {
"date": "2023-11-22",
"time": null,
"timezone": null,
"notes": null
},
"cutoff": {
"date": "2023-11-22",
"time": "10:00",
"timezone": "-05:00"
}
},
{
"branch": "localplus",
"id": "localplus",
"quantity": 17,
"name": "Local Plus - Next-day (if placed after cut off time)",
"branch_type": "alternative",
"delivery_date_time": {
"date": "2023-11-23",
"time": null,
"timezone": null,
"notes": null
},
"cutoff": {
"date": "2023-11-22",
"time": "15:00",
"timezone": "-05:00"
}
}
],
"delivery_date_time": null
}
]
},
{
"part_number": "001131",
"brand": "Bridgestone",
"suppliers": [
{
"id": "QnJpZGdlc3RvbmV8fDAwMTEzMXx8YnJpZGdlc3RvbmVpd3Nsd3N8fDM0MDI3fHxC",
"price": null,
"quantity": 8943,
"supplier": "bridgestoneiwslws",
"stock": [
{
"branch": "D009",
"id": "D009",
"quantity": 764,
"name": "D009 Ontario DC",
"branch_type": null,
"delivery_date_time": null,
"cutoff": null
},
{
"branch": "D011",
"id": "D011",
"quantity": 872,
"name": "D011 DFW DC",
"branch_type": null,
"delivery_date_time": null,
"cutoff": null
},
{
"Success",
"data": {
"nb_results": 2,
"branchtires": "D002",[
{
"idpart_number": "D002000063",
"brand": "Bridgestone",
"quantitystock": 7057,[
{
"name": "D002 Chicago DC", "tire_id": "QnJpZGdlc3RvbmV8fDAwMDA2M3x8YnJpZGdlc3RvbmVpd3Nsd3N8fDM0MDI3fHxC",
"branch_typesupplier": null,
"bridgestoneiwslws",
"deliverysupplier_date_timename": null,"Bridgestone DC (Run Day)",
"branches": [
"cutoff": null {
}, {"id": "D009",
"branchquantity": "D012"33,
"idname": "D012D009 Ontario DC",
"quantitydelivery_date_time": 250,{
"namedate": "D012 Lebanon DC",2023-11-22",
"branch_typetime": null,
"delivery_date_time "timezone": null,
"cutoffnotes": null
} },
], "delivery_date_time"cutoff": {null
"date": "2023-11-22",}
]
"time": null, "timezone": null,},
{
"notes": null "tire_id": "QnJpZGdlc3RvbmV8fDAwMDA2M3x8bnRkfHwzNDAyN3x8Qg==",
} "supplier": "ntd",
}, {"supplier_name": "NTD",
"idbranches": "QnJpZGdlc3RvbmV8fDAwMTEzMXx8bnRkfHwzNDAyN3x8Qg==",[
"price": null, {
"quantity": 139, "id": "localplus",
"supplier": "ntd", "quantity": 17,
"stock": [ "name": {"Local Plus",
"branchdelivery_date_time": "local",{
"iddate": "local2023-11-23",
"quantitytime": 63null,
"name": "Local - Same-day (if ordered before cut off time)", "timezone": null,
"branch_type": "primary",
notes": null
"delivery_date_time": { },
"datecutoff": "2023-11-22",{
"timedate": null"2023-11-22",
"timezonetime": null"15:00",
"notestimezone": null"-05:00"
},
}
"cutoff": { ]
"date": "2023-11-22",}
]
},
"time": "10:00", {
"part_number": "001131",
"timezonebrand": "-05:00Bridgestone",
"stock": [
} {
}"tire_id": "QnJpZGdlc3RvbmV8fDAwMTEzMXx8bnRkfHwzNDAyN3x8Qg==",
"supplier": "ntd",
{ "supplier_name": "NTD",
"branch": "localplus", "branches": [
"id": "localplus", {
"quantity": 76, "id": "local",
"name": "Local Plus - Next-day (if placed after cut off time)""quantity": 63,
"branch_typename": "alternativeLocal",
"delivery_date_time": {
"date": "2023-11-2322",
"time": null,
"timezone": null,
"notes": null
},
"cutoff": {
"date": "2023-11-22",
"time": "1510:00",
"timezone": "-05:00"
}
}
],
"delivery_date_time": null
}
]
}
]
}
} |
Response parameters
Parameter | Value | ||||
|---|---|---|---|---|---|
notice string | Response status | ||||
nb_results integer | Number of found tires | ||||
part_number string | Tire part number | ||||
brand string | Tire brand | ||||
suppliersstock[] array | Stock information | ||||
tire_id string | Tire ID | ||||
pricequantity floatinteger | Tire pricequantityquantity | ||||
supplier integerstring | Tire quantitySupplier | ||||
supplier_name string | Supplier nice name | ||||
stockbranches[] array | An array with stock per branch | ||||
branch string | Deprecated parameter | ||||
id string | Branch ID | ||||
quantity integer | Tire quantity | ||||
name string | Branch namebranch_type string | Branch type | |||
delivery_date_time object | Estimated delivery information specific for this branch | ||||
date string | Estimated delivery date | ||||
time string | Estimated delivery time | ||||
timezone string | Time zone | ||||
notes string | Information about estimated delivery | ||||
cutoff object | Information about cut off date&time for current branch | ||||
date string | Cut-off date | ||||
time string | Cut-off time | ||||
timezone string | Cut-off time zone | ||||
delivery_date_time object | Information about estimated delivery date & time that have no branch specific info | ||||
date string | Estimated Delivery date | ||||
timezone string | time string | Estimated Delivery time | Delivery time zone | notes string | Information about delivery |