This guide provides an overview of the TireConnect Fitment & Search APIs and explains how to use them to implement vehicle-based tire search.
You will learn how to retrieve vehicle data, determine tire fitments, and perform searches based on vehicle attributes such as year, make, model, and trim.

Table of contents

1 Swagger documentation
2 Authentication
3 Fitment
- 3.1 List of Years
- 3.2 List of Makes
- 3.3 List of Models
- 3.4 List of Submodels
- 3.5 List of Modifications
  - 3.5.1 By Year, Make, Model & Submodel
  - 3.5.2 By Vehicle ID (ACES ID)
  - 3.5.3 By Base Vehicle ID (Base ACES ID)
  - 3.5.4 By VIN
  - 3.5.5 By State & License Plate
- 3.6 List of Tire & Wheel Sizes
  - 3.6.1 OE (Tire & Wheel)
  - 3.6.2 Extended + Extreme (Tire)
  - 3.6.3 Extended + Extreme (Wheel)
4 Search
- 4.1 Tires
  - 4.1.1 Search Tire by Vehicle (OE Fitment)
  - 4.1.2 Search Tire by Vehicle (Extended + Extreme Fitment)
- 4.2 Wheels
  - 4.2.1 Search Wheel by Vehicle (OE + Extended Fitment)
  - 4.2.2 Search Wheel by Vehicle (Extreme Fitment)

Swagger documentation

Fitment API doc

Tire Search API doc

Wheel Search API doc

Authentication

All methods require an API key or token to be provided in the request headers.
To obtain a token, use the api/partner/auth or api/account/auth endpoints.

Request Example

curl --location 'https://devdemo.tireconnect.ca/api/partner/auth' \
--header 'Content-Type: application/json' \
--data '{
  "client_id": "{{client_id}}",
  "client_secret": "{{client_secret}}"
}'

Request parameters

client_id
^string

Client ID

^required

client_secret
^string

Client Secret

^required

Response Example

{
  "token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJkZWFsZXJfbG9jYXRpb24iOjEyNjc0LCJleHAiOjE1NjA1MjY1ODl9.uEjbXiu1EoZ5E9IyXDz4JEVySY4C_C5mYXCC6SsGTwOCXyU3tHJU79FJkh5X2uMUlJttIQwoyC1HqljDl7_zIj-6XxvT-ismKDmdW7z7ZqrsGi6N3VACx9Rt1o3aJvBdDkSw4QfqhE8DZlLsYDH-TIGEOUP6E462Rfxn8bE149g",
  "expire": 900
}

Response Parameters

token ^string	Authorisation token
expire ^int	expire time

Fitment

Fitment API

The Fitment API search is hierarchical.

To obtain fitment_id, vehicle_id and sizes needed for search methods you must sequentially retrieve the year, make, model, submodel or use vehicle_id or base_vehicle_id.

List of Years

POST api/fitment/v1/vehicle/year/list

Request Example

curl --location 'https://devdemo.tireconnect.ca/api/fitment/v1/vehicle/year/list' \
--header 'accept: application/json' \
--header 'Content-Type: application/json' \
--header 'token: {{token}}' \
--data '{
  "countries": [
    "US",
    "CA"
  ]
}'

Request parameters

countries
^array

Array of countries. Available options: US, CA

^optional

Response Example

{
    "success": true,
    "data": {
        "items": [
            2026,
            2025,
            2024,
           ...
        ]
    }
}

List of Makes

POST api/fitment/v1/vehicle/make/list

Request Example

curl --location 'https://devdemo.tireconnect.ca/api/fitment/v1/vehicle/make/list' \
--header 'accept: application/json' \
--header 'Content-Type: application/json' \
--header 'token: {{token}}' \
--data '{
  "year": 2021,
  "countries": [
    "US"
  ]
}'

Request parameters

year
^integer

Year

^required

countries
^array

Array of countries. Available options: US, CA

^optional

Response Example

{
    "success": true,
    "data": {
        "items": [
            "Acura",
            "Alfa Romeo",
            "Aston Martin",
            ...
        ]
    }
}

List of Models

POST api/fitment/v1/vehicle/model/list

Request Example

curl --location 'https://devdemo.tireconnect.ca/api/fitment/v1/vehicle/model/list' \
--header 'accept: application/json' \
--header 'Content-Type: application/json' \
--header 'token: {{token}}' \
--data '{
  "year": 2021,
  "countries": [
    "US"
  ],
  "make": "Ford"
}'

Request parameters

year
^integer

Year

^required

make
^string

Make

^required

countries
^array

Array of countries. Available options: US, CA

^optional

Response Example

{
    "success": true,
    "data": {
        "items": [
            "Bronco",
            "Bronco Sport",
            "E-350 Super Duty",
            ...
        ]
    }
}

List of Submodels

POST api/fitment/v1/vehicle/submodel/list

Request Example

curl --location 'https://devdemo.tireconnect.ca/api/fitment/v1/vehicle/submodel/list' \
--header 'accept: application/json' \
--header 'Content-Type: application/json' \
--header 'token: {{token}}' \
--data '{
  "year": 2021,
  "countries": [
    "US"
  ],
  "make": "Ford",
  "model": "F-150"
}'

Request parameters

year ^integer	Year ^required
make ^string	Make ^required
model ^string	Model ^required
countries ^array	Array of countries. Available options: US, CA ^optional

Response Example

{
    "success": true,
    "data": {
        "items": [
            "King Ranch",
            "Lariat",
            ...
        ]
    }
}

List of Modifications

To narrow the results and obtain a specific identifier for search, we recommend providing users with additional filters such as body type, option, drive type, and similar attributes.
As a result, you will obtain a fitment_id and, if applicable, alternate_fitment_ids.

Please note that the response example is the same for all methods listed below.

Response Example

{
    "success": true,
    "data": {
        "items": [
            {
                "year": 2021,
                "make": "Ford",
                "model": "F-150",
                "submodel": "XL",
                "base_vehicle_id": 152846,
                "vehicle_id": 271257,
                "country": "US",
                "option": "XL",
                "body_type": "Crew Cab Pickup",
                "drive_type": "4WD",
                "body_number_doors": 4,
                "bed_length": 67.1,
                "vehicle_type": "Truck",
                "liter": 3,
                "cc": 2993,
                "kw": 186,
                "horse_power": 250,
                "custom_note": null,
                "chassis_id": "90526",
                "fitment_id": "157895",
                "alternate_fitment_ids": [
                    "157868",
                    "157869",
                    "157907",
                    "157928",
                    "157929",
                    "157930",
                    "157931",
                    "157932",
                    "158023",
                    "181474"
                ]
            }
        ]
    }
}

Response parameters

year ^integer	Year
make ^string	Make
model ^string	Model
submodel ^string	Submodel
base_vehicle_id ^int	Base Vehicle ID (ACES Base ID)
vehicle_id ^int	Vehicle ID (ACES ID)
country ^string	Country
option ^string	Option
body_type ^string	Body type
body_type ^string	Body type
drive_type ^string	Drive type
body_number_doors ^string	Number of doors
bed_length ^string	Bed length
vehicle_type ^string	Type
liter ^int	Engine displacement (L)
cc ^int	Engine capacity (cc)
kw ^int	Engine power (kW)
horse_power ^int	Engine power (hp)
custom_note ^string	Custom note
chassis_id ^string	Chassis ID
fitment_id ^string	Fitment ID. Represents the vehicle’s default (factory-installed) tire or wheel size.
alternate_fitment_ids ^array	Array of alternative fitment IDs. Represent additional tire or wheel sizes that were available as factory options at the time of purchase.

By Year, Make, Model & Submodel

POST api/fitment/v1/vehicle/modification/list

Request Example

curl --location 'https://devdemo.tireconnect.ca/api/fitment/v1/vehicle/modification/list' \
--header 'accept: application/json' \
--header 'Content-Type: application/json' \
--header 'token: {{token}}' \
--data '{
  "year": 2021,
  "countries": [
    "US"
  ],
  "make": "Ford",
  "model": "F-150",
  "submodel": "XL"
}'

Request parameters

year ^integer	Year ^required
make ^string	Make ^required
model ^string	Model ^required
submodel ^string	Submodel ^required
countries ^array	Array of countries. Available options: US, CA ^optional

By Vehicle ID (ACES ID)

POST api/fitment/v1/vehicle/modification/list/by/vehicle-id

Request Example

curl --location 'https://devdemo.tireconnect.ca/api/fitment/v1/vehicle/modification/list/by/vehicle-id' \
--header 'accept: application/json' \
--header 'Content-Type: application/json' \
--header 'token: {{token}}' \
--data '{
  "vehicle_id": 271257
}'

Request parameters

vehicle_id
^integer

Vehicle ID (ACES ID)

^required

By Base Vehicle ID (Base ACES ID)

POST api/fitment/v1/vehicle/modification/list/by/base-vehicle-id

Request Example

curl --location 'https://devdemo.tireconnect.ca/api/fitment/v1/vehicle/modification/list/by/base-vehicle-id' \
--header 'accept: application/json' \
--header 'Content-Type: application/json' \
--header 'token: {{token}}' \
--data '{
  "base_vehicle_id": 152846
}'

Request parameters

base_vehicle_id
^integer

Base vehicle ID (ACES ID)

^required

By VIN

POST api/fitment/v1/vehicle/modification/list/by/vin

Request Example

curl --location 'https://devdemo.tireconnect.ca/api/fitment/v1/vehicle/modification/list/by/vin' \
--header 'accept: application/json' \
--header 'Content-Type: application/json' \
--header 'token: {{token}}' \
--data '{
  "vin": "2G1**********6472"
}'

Request parameters

vin
^string

VIN

^required

By State & License Plate

POST api/fitment/v1/vehicle/modification/list/by/license-plate

Request Example

curl --location 'https://devdemo.tireconnect.ca/api/fitment/v1/vehicle/modification/list/by/license-plate' \
--header 'accept: application/json' \
--header 'Content-Type: application/json' \
--header 'token: {{token}}' \
--data '{
  "state": "FL",
  "license": "*****"
}'

Request parameters

state
^string

State code

^required

license
^string

License

^required

List of Tire & Wheel Sizes

You should use methods listed below to show customer list of applicable tire or wheel sizes and then use it in search methods.

OE (Tire & Wheel)

POST api/fitment/v1/oe-fitment/list

To retrieve a list of OE sizes, use the fitment_ids (fitment_id + alternate_fitment_ids) obtained from the Modification methods.

fitment_id represents the vehicle’s default (factory-installed) tire or wheel size. You can use it alone or expand the search by including alternate_fitment_ids.
alternate_fitment_ids represent additional tire or wheel sizes that were available as factory options at the time of purchase.

Request Example

curl --location 'https://devdemo.tireconnect.ca/api/fitment/v1/oe-fitment/list' \
--header 'accept: application/json' \
--header 'Content-Type: application/json' \
--header 'token: {{token}}' \
--data '{
    "fitment_ids": [
        "154956",
        "150522"
    ]
}'

Request parameters

fitment_ids
^array

List of fitment IDs.

^required

Response Example

{
  "success": true,
  "data": {
    "items": [
      {
        "fitment_id": "150522",
        "chassis_id": "80349",
        "alternate_fitment_ids": [
          "154956",
          "160033",
          "83153"
        ],
        "tire": {
          "front": {
            "size_part_1": "225",
            "size_part_2": "40",
            "size_part_3": "19",
            "load_index": 93,
            "speed_rating": "Y",
            "load_range": null,
            "size_desc": "225/40R19 93Y"
          },
          "rear": {
            "size_part_1": "255",
            "size_part_2": "35",
            "size_part_3": "19",
            "load_index": 96,
            "speed_rating": "Y",
            "load_range": null,
            "size_desc": "255/35R19 96Y"
          }
        },
        "wheel": {
          "front": {
            "width": "8",
            "diameter": "19",
            "bolt_pattern": "5x112",
            "offset": 27,
            "centre_bore": 66.6
          },
          "rear": {
            "width": "8.5",
            "diameter": "19",
            "bolt_pattern": "5x112",
            "offset": 40,
            "centre_bore": 66.6
          }
        }
      },
      {
        "fitment_id": "154956",
        "chassis_id": "80349",
        "alternate_fitment_ids": [
          "150522",
          "160033",
          "83153"
        ],
        "tire": {
          "front": {
            "size_part_1": "225",
            "size_part_2": "45",
            "size_part_3": "18",
            "load_index": 94,
            "speed_rating": "V",
            "load_range": null,
            "size_desc": "225/45R18 94V"
          },
          "rear": null
        },
        "wheel": {
          "front": {
            "width": "7.5",
            "diameter": "18",
            "bolt_pattern": "5x112",
            "offset": 25,
            "centre_bore": 66.6
          },
          "rear": null
        }
      }
    ]
  }
}

Response parameters

fitment_id ^string	Fitment ID
chassis_id ^string	Chassis ID
alternate_fitment_ids ^array	Array of alternative fitment IDs
tire ^object	Object with tire size
front ^object	Front tire size
size_part_1 ^string	Size part 1
size_part_2 ^string	Size part 2
size_part_3 ^string	Size part 3
load_index ^integer	Load index
speed_rating ^string	Speed rating
load_range ^string	Load range
size_desc ^string	Size description. Can be used on UI
rear ^object	Rear tire size
wheel ^object	Object with wheel size
front ^object	Front wheel size
width ^string	Width
diameter ^string	Diameter
bolt_pattern ^string	Bolt pattern
offset ^integer	Offset
centre_bore ^float	Centre bore
rear ^object	Rear wheel size

Extended + Extreme (Tire)

POST api/fitment/v1/tire/extended-fitment/list

To retrieve a list of Extended and Extreme sizes, use the fitment_id and vehicle_id obtained from the Modification methods.

Request Example

curl --location 'https://devdemo.tireconnect.ca/api/fitment/v1/tire/extended-fitment/list' \
--header 'accept: application/json' \
--header 'Content-Type: application/json' \
--header 'token: {{token}}' \
--data '{
  "fitment_id": "157895",
  "vehicle_id": 279230,
  "include_extreme": true
}'

Request parameters

fitment_id
^string

Fitment ID

^required

vehicle_id
^string

Vehicle ID

^required

include_extreme
^string

This option allows you to get list of Extreme fitments alongside with list of of Extended fitments

^required

Response Example

{
  "success": true,
  "data": {
    "items": [
      {
        "tire": {
          "front": {
            "size_part_1": "285",
            "size_part_2": "60",
            "size_part_3": "18",
            "size_desc": "285/60R18",
            "type": "extended",
            "notes": []
          },
          "rear": null,
          "is_extreme": false,
          "fitment": {
            "type": "extended",
            "notes": []
          }
        }
      },
      {
        "tire": {
          "front": {
            "size_part_1": "33",
            "size_part_2": "10.5",
            "size_part_3": "20",
            "size_desc": "33/10.5R20",
            "type": "extreme",
            "notes": [
              "Check fitment, possible clearance issues",
              "Extreme fitment/check lift kit requirements"
            ]
          },
          "rear": null,
          "is_extreme": true,
          "fitment": {
            "type": "extreme",
            "notes": [
              "Check fitment, possible clearance issues",
              "Extreme fitment/check lift kit requirements"
            ]
          }
        }
      }
    ]
  }
}

Response parameters

size_part_3^string
tire ^object	Object with tire size
front ^object	Front tire
size_part_1 ^string	Size part 1
size_part_2 ^string	Size part 2

TireConnect Vehicle Search API

Swagger documentation

Authentication

Fitment

List of Years

List of Makes

List of Models

List of Submodels

List of Modifications

By Year, Make, Model & Submodel

By Vehicle ID (ACES ID)

By Base Vehicle ID (Base ACES ID)

By VIN

By State & License Plate

List of Tire & Wheel Sizes

OE (Tire & Wheel)

Extended + Extreme (Tire)