Request example
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 '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 |
Response example
{
"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
},
{
"branch": "D002",
"id": "D002",
"quantity": 7057,
"name": "D002 Chicago DC",
"branch_type": null,
"delivery_date_time": null,
"cutoff": null
},
{
"branch": "D012",
"id": "D012",
"quantity": 250,
"name": "D012 Lebanon DC",
"branch_type": null,
"delivery_date_time": null,
"cutoff": null
}
],
"delivery_date_time": {
"date": "2023-11-22",
"time": null,
"timezone": null,
"notes": null
}
},
{
"id": "QnJpZGdlc3RvbmV8fDAwMTEzMXx8bnRkfHwzNDAyN3x8Qg==",
"price": null,
"quantity": 139,
"supplier": "ntd",
"stock": [
{
"branch": "local",
"id": "local",
"quantity": 63,
"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": 76,
"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
}
]
}
]
}
}
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 |
suppliers[] array | Stock information |
id string | Tire ID |
price float | Tire price |
quantity integer | Tire quantity |
supplier string | Supplier |
stock[] array | An array with stock per branch |
branch string | Deprecated parameter |
id string | Branch ID |
quantity integer | Tire quantity |
name string | Branch name |
branch_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 |
time string | Estimated Delivery time |
timezone string | Delivery time zone |
notes string | Information about delivery |