Tire Size & Wheel Fitment API Help Center

Getting Started

Go to account-tire.vdim.app/signin/signup
Enter your name, email, and password and click Create Account
Verify your email via the confirmation link we send you
Once verified, log in and you will land on your dashboard

From your dashboard, go to Plans and choose Free, Growth, Premium, or Enterprise
Complete checkout — the Free plan requires no payment
Your API key is generated automatically and shown on the API Key tab
Copy the key — you'll include it in every request as a header

You can also test the API using our live demo before signing up

Replace YOUR_API_KEY with your key and run this in your terminal:

curl -H "x-api-key: YOUR_API_KEY" \
  "https://tire.vdim.app/api/v1/tire-dimensions?year=2022&make=Toyota&model=Camry"

You should get a JSON response with tire specifications
If you get a 401, double-check the header name is exactly x-api-key

Authentication & API Keys

Log in to account-tire.vdim.app/account and click the API Key tab
Your active key is displayed there — copy it to use in your requests
You can regenerate it at any time — regenerating immediately invalidates the old key

Pass it as a request header named x-api-key — do not put it in the URL as a query parameter

# cURL
curl -H "x-api-key: YOUR_API_KEY" "https://tire.vdim.app/api/v1/..."

# JavaScript (fetch)
fetch("https://tire.vdim.app/api/v1/...", {
  headers: { "x-api-key": "YOUR_API_KEY" }
});

# Python (requests)
import requests
r = requests.get("https://tire.vdim.app/api/v1/...",
  headers={"x-api-key": "YOUR_API_KEY"})

Check that the header name is exactly x-api-key — not X-API-Key or apikey
Make sure you haven't exceeded your daily request limit — check your dashboard usage
If your subscription expired, renew it from the Plans section
If you regenerated your key recently, update it in your code — the old key is permanently invalidated
If none of the above apply, contact support

Making Requests

Use the /tire-dimensions endpoint with year, make, and model:

GET /api/v1/tire-dimensions?year=2022&make=Toyota&model=Camry&trim=LE

All parameters except trim are required
Use /search_allyear and /search_allmake first to get valid values for dropdowns

Search by aspect ratio — returns matching tire sizes for a given width:

GET /api/v1/by_size/aspectratio?width=225

Search by diameter — narrows results by width and aspect ratio:

GET /api/v1/by_size/diameter?width=225&aspectratio=45

All makes: GET /api/v1/search_allmake
All years: GET /api/v1/search_allyear
All widths: GET /api/v1/search_allwidth
Year range for a make: GET /api/v1/year_range?make=Toyota

These endpoints are highly cacheable — cache for at least 24 hours to reduce your daily usage

Each plan has a daily request limit that resets at midnight UTC
Free: 300 requests/day
Growth: 5,000 requests/day
Premium: 200,000 requests/day
Enterprise: 50,000 requests/day (custom limits available)
When you hit the limit you receive a 429 Too Many Requests response — monitor usage from your dashboard

Understanding Responses

{
  "year": "2022",
  "make": "Toyota",
  "model": "Camry",
  "trim": "LE",
  "front": {
    "width": 235,
    "aspectRatio": 45,
    "diameter": 18,
    "tireSize": "235/45R18",
    "loadIndex": 94,
    "speedRating": "V"
  },
  "rear": {
    "width": 235,
    "aspectRatio": 45,
    "diameter": 18,
    "tireSize": "235/45R18",
    "loadIndex": 94,
    "speedRating": "V"
  }
}

front and rear may differ for performance vehicles with staggered fitments
If they match, the vehicle uses a square setup

Load Index — maximum weight per tire (e.g. 94 = 670 kg per tire)
Speed Rating — maximum sustained speed the tire is rated for:

H — up to 210 km/h
V — up to 240 km/h
W — up to 270 km/h
Y — up to 300 km/h

Different trim levels often come with different wheel and tire sizes
Example: a base LE trim may use 17" wheels while the XSE uses 18"
Always filter by trim for exact fitment, or display all trims and let the user select theirs

Error Troubleshooting

Code	Meaning	Fix
401	Unauthorized	Missing or invalid `x-api-key` header
429	Too Many Requests	Daily limit reached — wait for midnight UTC reset or upgrade
404	Not Found	No data found — check spelling of make/model/year
400	Bad Request	Missing required parameter — check the API docs
500	Server Error	Our side — check API Status and retry

Header name must be exactly x-api-key — not X-API-Key or apikey
Check for leading or trailing spaces in the key value
Confirm your subscription is active in your dashboard
If you recently regenerated your key, make sure you're using the new one

Use /search_allmake to get the exact make string — spelling matters (e.g. Land Rover not Land-Rover)
Use /year_range?make=Toyota to confirm the year is within our dataset
Try without the trim parameter to get all trims for that model first

Account & Billing

Log in to account-tire.vdim.app/account and go to the Usage tab
You'll see your daily request count and remaining quota
Or call GET /api/v1/usage with your API key to get usage data programmatically

Go to your dashboard and click Plans
Select the new plan
Confirm — upgrades take effect immediately, downgrades apply at the next billing cycle

Go to your dashboard, click Plans, then Cancel Subscription
Access continues until the end of the billing period, then reverts to the Free tier (300 requests/day)
Having trouble? Contact us and we'll help

Go to your dashboard, click the API Key tab, then Regenerate Key
Your old key is invalidated immediately — update all your applications first

How can we help?

Getting Started

Authentication

Making Requests

Still need help?

How can we help?

Getting Started

Authentication

Making Requests

Still need help?

💬 Chat with us!