Getting Started

Welcome to the Tire Library API. This API provides read-only access to our tire catalog, vehicle fitment data, and rebate information.

Authentication

All API requests must include your company's API key via the x-api-key header:

x-api-key: tl_live_your_key

Quick Start

curl -H "x-api-key: tl_live_your_key" \
  "https://app.tireweblibrary.com/api/v1/tires/search?width=205&aspect_ratio=65&rim_size=15"

const response = await fetch(
  "https://app.tireweblibrary.com/api/v1/tires/search?width=205&aspect_ratio=65&rim_size=15",
  { headers: { "x-api-key": "tl_live_your_key" } }
);
const data = await response.json();

import requests

response = requests.get(
    "https://app.tireweblibrary.com/api/v1/tires/search",
    params={"width": "205", "aspect_ratio": "65", "rim_size": "15"},
    headers={"x-api-key": "tl_live_your_key"},
)
data = response.json()

Rate Limits

API requests are limited to 100 requests per minute per company, shared across all API keys. Exceeding this limit returns a 429 Too Many Requests response.

Read-Only Access

API keys only support GET requests. POST, PUT, PATCH, and DELETE requests will receive a 405 Method Not Allowed response.

Error Responses

Base URL & Versioning

All endpoints are versioned via the URL path. The current version is v1:

https://app.tireweblibrary.com/api/v1/

Every request must include the version segment. Requests without a version (e.g. /api/tires/search) will return a 400 error with the message Unsupported API version.

Response Format

All responses are JSON with snake_case property names. All string filter values are case-insensitive — for example, make_name=Michelin and make_name=MICHELIN produce the same results. Paginated endpoints return a standard envelope:

{
  "current_page": 1,
  "data": [ ... ],
  "from": 1,
  "last_page": 5,
  "per_page": 20,
  "to": 20,
  "total": 100
}

Pagination

Several endpoints return paginated results. Control pagination with two query parameters:

Default per_page by Endpoint

Paginated Response Fields

Iterating Pages

Fetch page 1, check last_page, then request subsequent pages:

# Fetch first page
curl -H "x-api-key: tl_live_your_key" \
  "https://app.tireweblibrary.com/api/v1/tires/search?width=205&per_page=100&page=1"

# Fetch subsequent pages by incrementing the page parameter

let page = 1;
let allResults = [];

while (true) {
  const res = await fetch(
    `https://app.tireweblibrary.com/api/v1/tires/search?width=205&per_page=100&page=${page}`,
    { headers: { "x-api-key": "tl_live_your_key" } }
  );
  const data = await res.json();
  allResults.push(...data.data);

  if (page >= data.last_page) break;
  page++;
}

import requests

all_results = []
page = 1

while True:
    response = requests.get(
        "https://app.tireweblibrary.com/api/v1/tires/search",
        params={"width": "205", "per_page": 100, "page": page},
        headers={"x-api-key": "tl_live_your_key"},
    )
    data = response.json()
    all_results.extend(data["data"])

    if page >= data["last_page"]:
        break
    page += 1

Two Ways to Access the Catalog

Available Endpoints

OpenAPI Specification

The API provides a machine-readable OpenAPI 3.0 specification (also known as Swagger). You can use it to generate client SDKs, import into API tools, or explore the API interactively.

Using the OpenAPI Spec

Import into API tools: Load the JSON URL into Postman, Insomnia, or Hoppscotch to get a pre-configured collection of all endpoints.

Generate client SDKs: Use OpenAPI Generator to create type-safe clients in your language:

# Install the generator CLI
npm install @openapitools/openapi-generator-cli -g

# Generate a TypeScript client
openapi-generator-cli generate \
  -i https://app.tireweblibrary.com/api/swagger/v1/swagger.json \
  -g typescript-axios \
  -o ./tire-library-client

// Install via npx (no global install needed)
// npx @openapitools/openapi-generator-cli generate \
//   -i https://app.tireweblibrary.com/api/swagger/v1/swagger.json \
//   -g javascript \
//   -o ./tire-library-client

# Generate a Python client
# npx @openapitools/openapi-generator-cli generate \
#   -i https://app.tireweblibrary.com/api/swagger/v1/swagger.json \
#   -g python \
#   -o ./tire-library-client

Tires

Three endpoints for discovering and inspecting tires: a simple dimensional search, a full faceted catalog browser, and a detail endpoint for individual tire sizes.

Search Tires

Search tire sizes by dimensional attributes. Returns paginated results with basic tire information.

Query Parameters

Code Examples

curl -H "x-api-key: tl_live_your_key" \
  "https://app.tireweblibrary.com/api/v1/tires/search?width=205&aspect_ratio=65&rim_size=15"

const response = await fetch(
  "https://app.tireweblibrary.com/api/v1/tires/search?width=205&aspect_ratio=65&rim_size=15",
  { headers: { "x-api-key": "tl_live_your_key" } }
);
const data = await response.json();

import requests

response = requests.get(
    "https://app.tireweblibrary.com/api/v1/tires/search",
    params={"width": "205", "aspect_ratio": "65", "rim_size": "15"},
    headers={"x-api-key": "tl_live_your_key"},
)
data = response.json()

Response

{
  "current_page": 1,
  "data": [
    {
      "id": 12345,
      "name": "205/65R15",
      "item_number": "12345",
      "tire_model_id": 678,
      "tire_make_id": 90,
      "width": "205",
      "aspect_ratio": "65",
      "rim_size": "15",
      "load_rating": "97",
      "speed_rating": "H",
      "make_name": "Michelin",
      "model_name": "Defender T+H",
      "season": "All Season",
       "category": "Passenger",
       "three_pmsf": false,
       "run_flat": false,
       "mud_and_snow": true,
       "size_format": "Modern",
       "thumbnail_image": null,
       "angle_image_url": "https://...",
       "side_image_url": "https://...",
       "side2_image_url": "https://...",
       "front_image_url": "https://...",
       "rotation_image_url": "https://...",
       "image_url": "https://..."
     }
   ],
   "from": 1,
   "last_page": 3,
   "per_page": 20,
   "to": 20,
   "total": 55
 }

Response Fields

Error Responses

Related Endpoints

• Tire Makes — get make IDs and names for the tire_make_id field
• Tire Patterns — get pattern details for the tire_model_id field
• Tire Categories — reference list of category values for the exclude_category filter

Browse Catalog

Full-featured faceted catalog browser. Returns matching tires along with available facet values for building interactive filters. Most parameters accept multiple values — repeat the query parameter for each value.

Query Parameters

Code Examples

curl -H "x-api-key: tl_live_your_key" \
  "https://app.tireweblibrary.com/api/v1/tires/catalog?make_name=Michelin&per_page=30"

const response = await fetch(
  "https://app.tireweblibrary.com/api/v1/tires/catalog?make_name=Michelin&per_page=30",
  { headers: { "x-api-key": "tl_live_your_key" } }
);
const data = await response.json();

import requests

response = requests.get(
    "https://app.tireweblibrary.com/api/v1/tires/catalog",
    params={"make_name": "Michelin", "per_page": 30},
    headers={"x-api-key": "tl_live_your_key"},
)
data = response.json()

Response

{
  "results": {
    "current_page": 1,
    "data": [
      {
        "id": 12345,
        "name": "205/65R15",
        "item_number": "12345",
        "tire_model_id": 678,
        "tire_make_id": 90,
        "width": "205",
        "aspect_ratio": "65",
        "rim_size": "15",
        "load_rating": "97",
        "speed_rating": "H",
        "make_name": "Michelin",
        "model_name": "Defender T+H",
        "season": "All Season",
        "category": "Passenger",
        "warranty": "90000",
        "ply_rating": "4",
        "load_range": "SL",
        "utqg": "820 A B",
        "tread_depth": "9.5",
        "weight": "22",
        "make_image": "https://...",
        "terrain": "Highway",
         "studdable": false,
         "three_pmsf": false,
         "run_flat": false,
         "mud_and_snow": true,
         "size_format": "Modern",
         "thumbnail_image": null,
         "angle_image_url": "https://...",
         "side_image_url": "https://...",
         "side2_image_url": "https://...",
         "front_image_url": "https://...",
       "front_image_url": "https://...",
       "side2_image_url": "https://...",
       "front_image_url": "https://...",
         "rotation_image_url": "https://...",
       "rotation_image_url": "https://...",
         "image_url": "https://..."
      }
    ],
    "from": 1,
    "last_page": 5,
    "per_page": 30,
    "to": 30,
    "total": 150
  },
  "facets": {
    "make_name": ["Michelin", "Bridgestone", "Goodyear", "..."],
    "width": ["155", "165", "175", "185", "195", "205", "..."],
    "aspect_ratio": ["40", "45", "50", "55", "60", "65", "..."],
    "rim_size": ["14", "15", "16", "17", "18", "..."],
    "speed_rating": ["H", "V", "W", "Y", "..."],
    "load_rating": ["93", "97", "101", "..."],
    "ply_rating": ["4", "6", "8", "..."],
    "load_range": ["SL", "XL", "E", "..."],
    "utqg": ["820 A B", "740 A A", "..."],
    "warranty": ["90000", "80000", "60000", "..."],
    "season": ["All Season", "Winter", "Summer", "..."],
    "terrain": ["Highway", "All-Terrain", "Mud-Terrain", "..."],
    "category": ["Passenger", "Light Truck", "..."],
    "size_format": ["Imperial", "Imperial Truck", "Lawn and Garden", "Modern", "OD"]
  }
}

Response Fields

Error Responses

Related Endpoints

• Tire Makes — get make names for the make_name filter
• Tire Categories — reference list of category values for the category and exclude_category filters

Get Tire by ID

Get the full specification sheet for a single tire size, including dimensions, performance ratings, images, rebates, and vehicle fitments.

Path Parameters

Query Parameters

Code Examples

curl -H "x-api-key: tl_live_your_key" \
  "https://app.tireweblibrary.com/api/v1/tires/12345"

# Only include active rebates
curl -H "x-api-key: tl_live_your_key" \
  "https://app.tireweblibrary.com/api/v1/tires/12345?rebate_status=Active"

const response = await fetch(
  "https://app.tireweblibrary.com/api/v1/tires/12345",
  { headers: { "x-api-key": "tl_live_your_key" } }
);
const tire = await response.json();

// Only include active rebates
const response2 = await fetch(
  "https://app.tireweblibrary.com/api/v1/tires/12345?rebate_status=Active",
  { headers: { "x-api-key": "tl_live_your_key" } }
);
const tire2 = await response2.json();

import requests

response = requests.get(
    "https://app.tireweblibrary.com/api/v1/tires/12345",
    headers={"x-api-key": "tl_live_your_key"},
)
tire = response.json()

# Only include active rebates
response = requests.get(
    "https://app.tireweblibrary.com/api/v1/tires/12345",
    params={"rebate_status": "Active"},
    headers={"x-api-key": "tl_live_your_key"},
)
tire = response.json()

Response

{
  "id": 12345,
  "name": "205/65R15",
  "item_number": "12345",
  "upc": "086699212345",
  "ean": "00866992123455",
  "asin": "B0CX12AB34",
  "gm_code": "356096357",
  "width": "205",
  "aspect_ratio": "65",
  "rim_size": "15",
  "load_rating": "97",
  "speed_rating": "H",
  "price": "129.99",
  "load_capacity_dual": "1709",
  "load_capacity_single": "1609",
  "max_inflation_pressure": "44",
  "revolutions_per_mile": "775",
  "rolling_circumference": "81.8",
  "diameter_overall": "25.5",
  "sidewall": "5.3",
  "section_width": "8.5",
  "weight": "22",
  "warranty": "90000",
  "utqg": "820 A B",
  "ply_rating": "4",
  "load_range": "SL",
  "tread_depth": "9.5",
  "category": "Passenger",
  "season": "All Season",
  "terrain": "Highway",
  "studdable": false,
  "three_pmsf": false,
  "run_flat": false,
  "mud_and_snow": true,
  "thumbnail_image": null,
  "tire_make": {
    "id": 90,
    "name": "Michelin",
    "image_url": "https://...",
    "dot_reg_url": "https://..."
  },
  "tire_model": {
    "id": 678,
    "name": "Defender T+H",
    "image_url": "https://...",
    "angle_image_url": "https://...",
    "side_image_url": "https://...",
    "side2_image_url": "https://...",
    "front_image_url": "https://...",
    "rotation_image_url": "https://...",
    "rotation_frame_count": 36,
    "image_360_url": "https://...",
    "image_360_thumbnail_url": "https://...",
    "video_url": "https://...",
    "manufacturer_url": "https://...",
    "features": "Extended tread life...",
    "benefits": "All-season confidence...",
    "description": "...",
    "three_pmsf": false
  },
  "rebates": [
    {
      "id": 10,
      "name": "Spring Rebate",
      "description": "Save on select Michelin tires",
      "start_date": "2025-03-01",
      "end_date": "2025-05-31",
      "global": false,
      "status": "Active"
    }
  ],
  "fitments_grouped": {
    "Chevrolet": {
      "Equinox": [
        { "trim": "L", "years": "2018-2021", "year_list": [2018, 2019, 2020, 2021] },
        { "trim": "LS", "years": "2018-2024", "year_list": [2018, 2019, 2020, 2021, 2022, 2023, 2024] },
        { "trim": "LT", "years": "2018-2024", "year_list": [2018, 2019, 2020, 2021, 2022, 2023, 2024] }
      ]
    },
    "Ford": {
      "Escape": [
        { "trim": "SE", "years": "2020-2022", "year_list": [2020, 2021, 2022] }
      ]
    }
  }
}

Response Fields

Error Responses

Related Endpoints

• Tire Patterns — get pattern details for the tire_model_id
• Tire Makes — get make details for the tire_make_id
• Vehicle Fitments — look up vehicles that fit this tire size
• Rebates — get full rebate details

Tire Makes

List all tire makes (manufacturers) in the catalog. Returns the make ID, name, logo image, and DOT registration URL for each make.

List Tire Makes

Returns all tire makes sorted alphabetically by name. No pagination — the dataset is small enough to return in a single request.

Code Examples

curl -H "x-api-key: tl_live_your_key" \
  "https://app.tireweblibrary.com/api/v1/tire-makes"

const response = await fetch(
  "https://app.tireweblibrary.com/api/v1/tire-makes",
  { headers: { "x-api-key": "tl_live_your_key" } }
);
const makes = await response.json();

import requests

response = requests.get(
    "https://app.tireweblibrary.com/api/v1/tire-makes",
    headers={"x-api-key": "tl_live_your_key"},
)
makes = response.json()

Response

[
  {
    "id": 90,
    "name": "Michelin",
    "image_url": "https://...",
    "dot_reg_url": "https://..."
  },
  {
    "id": 42,
    "name": "Bridgestone",
    "image_url": "https://...",
    "dot_reg_url": null
  }
]

Response Fields

Error Responses

Related Endpoints

• Tire Patterns — use id as the make_id parameter to list patterns for a make, or use search to match patterns by name across all makes
• Tires — use name as the make_name filter in catalog endpoints
• Rebates — filter rebates by make_name on the list endpoint

Common Make Names

The catalog contains 650+ makes. The most commonly used makes are:

Tire Categories

List all tire categories in the catalog. Categories classify tires by application (e.g. “Passenger Car”, “Commercial Truck/Bus”, “Agricultural”). Use these values with the category and exclude_category filters on search and catalog endpoints.

List Tire Categories

Returns all tire categories sorted by tire count (most common first). No pagination — the dataset is small enough to return in a single request.

Code Examples

curl -H "x-api-key: tl_live_your_key" \
  "https://app.tireweblibrary.com/api/v1/tire-categories"

const response = await fetch(
  "https://app.tireweblibrary.com/api/v1/tire-categories",
  { headers: { "x-api-key": "tl_live_your_key" } }
);
const categories = await response.json();

import requests

response = requests.get(
    "https://app.tireweblibrary.com/api/v1/tire-categories",
    headers={"x-api-key": "tl_live_your_key"},
)
categories = response.json()

Response

Returns a flat JSON array of category strings, ordered by tire count descending.

[
  "Commercial Truck/Bus",
  "Passenger Car",
  "Passenger Light Truck/SUV, Light Truck",
  "Agricultural, Lawn & Garden/Golf",
  "Trailer, Special Trailer (ST)",
  "Passenger Car, CAR, Performance, UHP",
  "OTR/Construction, Earthmover",
  "..."
]

Response Fields

Error Responses

Related Endpoints

• Tires — use category values with category and exclude_category filters
• Tire Patterns — use category values with category and exclude_category filters

Category Reference

The complete list of 70 tire categories, grouped by application.

Passenger Car

Passenger Light Truck/SUV

Commercial

Agricultural

OTR/Construction

Industrial

Sport ATV/UTV

Trailer

Motorcycle

Temporary Spare

Undefined

Tire Patterns

Three endpoints for discovering tire patterns: list patterns by make or by name search, browse with faceted filters, or get full details for a single pattern.

List Tire Patterns

Returns tire patterns, optionally filtered by make and/or pattern name, sorted alphabetically by name. No pagination — the dataset is small enough to return in a single request. The make_id parameter is optional; when omitted, search is required and matches pattern names across all makes.

Query Parameters

Code Examples

curl -H "x-api-key: tl_live_your_key" \
  "https://app.tireweblibrary.com/api/v1/tire-patterns?make_id=90"

# Filter patterns by name
curl -H "x-api-key: tl_live_your_key" \
  "https://app.tireweblibrary.com/api/v1/tire-patterns?make_id=90&search=alpin"

# Search patterns by name across all makes (make_id optional)
curl -H "x-api-key: tl_live_your_key" \
  "https://app.tireweblibrary.com/api/v1/tire-patterns?search=ventus"

const response = await fetch(
  "https://app.tireweblibrary.com/api/v1/tire-patterns?make_id=90",
  { headers: { "x-api-key": "tl_live_your_key" } }
);
const patterns = await response.json();

// Filter patterns by name
const filtered = await fetch(
  "https://app.tireweblibrary.com/api/v1/tire-patterns?make_id=90&search=alpin",
  { headers: { "x-api-key": "tl_live_your_key" } }
);
const matches = await filtered.json();

// Search patterns by name across all makes (make_id optional)
const byName = await fetch(
  "https://app.tireweblibrary.com/api/v1/tire-patterns?search=ventus",
  { headers: { "x-api-key": "tl_live_your_key" } }
);
const nameMatches = await byName.json();

import requests

response = requests.get(
    "https://app.tireweblibrary.com/api/v1/tire-patterns",
    params={"make_id": 90},
    headers={"x-api-key": "tl_live_your_key"},
)
patterns = response.json()

# Filter patterns by name
response = requests.get(
    "https://app.tireweblibrary.com/api/v1/tire-patterns",
    params={"make_id": 90, "search": "alpin"},
    headers={"x-api-key": "tl_live_your_key"},
)
matches = response.json()

# Search patterns by name across all makes (make_id optional)
response = requests.get(
    "https://app.tireweblibrary.com/api/v1/tire-patterns",
    params={"search": "ventus"},
    headers={"x-api-key": "tl_live_your_key"},
)
name_matches = response.json()

Response

[
  {
    "id": 42,
    "name": "Alpin 6",
    "description": "Winter tire for passenger cars",
    "image_url": "https://...",
    "angle_image_url": "https://...",
    "side_image_url": "https://...",
    "side2_image_url": "https://...",
    "front_image_url": "https://...",
    "rotation_image_url": "https://...",
    "rotation_frame_count": 36,
    "size_count": 34
  },
  {
    "id": 43,
    "name": "CrossClimate 2",
    "description": "All-season tire with winter certification",
    "image_url": "https://...",
    "angle_image_url": null,
    "side_image_url": null,
    "side2_image_url": null,
    "front_image_url": null,
    "rotation_image_url": null,
    "rotation_frame_count": null,
    "size_count": 89
  }
]

Response Fields

Error Responses

Related Endpoints

• List tire makes — get make_id values, or use search to match patterns across all makes
• Tire Categories — reference list of category values
• Tire catalog — filter tires by make name via GET /api/v1/tires/catalog?make_name=Michelin

Browse Catalog

Browse tire patterns with optional filtering by make name and free-text search. Returns paginated results with facets for building interactive filters.

Query Parameters

Code Examples

curl -H "x-api-key: tl_live_your_key" \
  "https://app.tireweblibrary.com/api/v1/tire-patterns/catalog?make_name=Michelin"

const response = await fetch(
  "https://app.tireweblibrary.com/api/v1/tire-patterns/catalog?make_name=Michelin",
  { headers: { "x-api-key": "tl_live_your_key" } }
);
const data = await response.json();

import requests

response = requests.get(
    "https://app.tireweblibrary.com/api/v1/tire-patterns/catalog",
    params={"make_name": "Michelin"},
    headers={"x-api-key": "tl_live_your_key"},
)
data = response.json()

Response

{
  "results": {
    "current_page": 1,
    "data": [
      {
        "id": 678,
        "name": "Defender T+H",
        "description": "All-season tire...",
        "image_url": "https://...",
        "angle_image_url": "https://...",
    "side_image_url": "https://...",
    "side2_image_url": "https://...",
    "front_image_url": "https://...",
    "rotation_image_url": "https://...",
    "rotation_frame_count": 36,
        "make_name": "Michelin",
        "make_image": "https://...",
        "size_count": 42
      }
    ],
    "from": 1,
    "last_page": 4,
    "per_page": 24,
    "to": 24,
    "total": 85
  },
  "facets": {
    "make_name": ["Michelin", "Bridgestone", "Goodyear", "..."],
    "category": ["Passenger Car", "Light Truck", "Commercial Truck/Bus", "..."]
  }
}

Response Fields

Error Responses

Related Endpoints

• Tire Makes — get make names for the make_name filter
• Tire Categories — reference list of category values for the category and exclude_category filters
• Tires — search for specific tire sizes by dimensional attributes

Get Tire Pattern by ID

Get full detail for a single tire pattern, including all its available sizes and applicable rebates.

Path Parameters

Query Parameters

Code Examples

curl -H "x-api-key: tl_live_your_key" \
  "https://app.tireweblibrary.com/api/v1/tire-patterns/678"

# Only include active rebates
curl -H "x-api-key: tl_live_your_key" \
  "https://app.tireweblibrary.com/api/v1/tire-patterns/678?rebate_status=Active"

const response = await fetch(
  "https://app.tireweblibrary.com/api/v1/tire-patterns/678",
  { headers: { "x-api-key": "tl_live_your_key" } }
);
const pattern = await response.json();

// Only include active rebates
const response2 = await fetch(
  "https://app.tireweblibrary.com/api/v1/tire-patterns/678?rebate_status=Active",
  { headers: { "x-api-key": "tl_live_your_key" } }
);
const pattern2 = await response2.json();

import requests

response = requests.get(
    "https://app.tireweblibrary.com/api/v1/tire-patterns/678",
    headers={"x-api-key": "tl_live_your_key"},
)
pattern = response.json()

# Only include active rebates
response = requests.get(
    "https://app.tireweblibrary.com/api/v1/tire-patterns/678",
    params={"rebate_status": "Active"},
    headers={"x-api-key": "tl_live_your_key"},
)
pattern = response.json()

Response

{
  "id": 678,
  "name": "Defender T+H",
  "image_url": "https://...",
  "angle_image_url": "https://...",
    "side_image_url": "https://...",
    "side2_image_url": "https://...",
    "front_image_url": "https://...",
    "rotation_image_url": "https://...",
    "rotation_frame_count": 36,
  "image_360_url": "https://...",
  "image_360_thumbnail_url": "https://...",
  "video_url": "https://...",
  "manufacturer_url": "https://...",
  "benefits": "All-season confidence...",
  "description": "The Michelin Defender...",
  "features": "IntelliSipe Technology...",
  "three_pmsf": false,
  "tire_make": {
    "id": 90,
    "name": "Michelin",
    "image_url": "https://...",
    "dot_reg_url": "https://..."
  },
  "tire_sizes": [
    {
      "id": 12345,
      "name": "205/65R15",
      "item_number": "12345",
      "three_pmsf": false,
      "season": "All Season",
      "terrain": "Highway",
      "studdable": false,
      "category": "Passenger",
      "run_flat": false,
      "mud_and_snow": true
    }
  ],
  "rebates": [
    {
      "id": 10,
      "name": "Spring Rebate",
      "description": "Save on select Michelin tires",
      "start_date": "2025-03-01",
      "end_date": "2025-05-31",
      "global": false,
      "status": "Active"
    }
  ]
}

Response Fields

Error Responses

Angle Images

angle_image_url is a 500x500 pixel PNG photo of the tread at an angle, served with long-lived caching. The ?v= query string changes when the image set is updated, so always use the URL exactly as returned. Coverage is partial (~10,900 of ~20,000 patterns, about 55%); the field is null when no angle image exists for a pattern.

Related Endpoints

• Tires — get full specifications for a tire size within this pattern
• Vehicle Fitments — look up vehicles that fit the tire sizes in this pattern
• Rebates — get full rebate details for rebates returned in the response

Vehicle Fitments

Look up tire fitments for a specific vehicle. Supports a cascading selector pattern — pass parameters incrementally to drill down from year to make to model to trim.

Vehicle Lookup

Pass year to get available makes. Add make to get models. Add model to get trims. Add trim to get tire fitment results. Omit all parameters to get available years.

Query Parameters

Code Examples

Step 1 — Get available years:

curl -H "x-api-key: tl_live_your_key" \
  "https://app.tireweblibrary.com/api/v1/vehicle/lookup"

const response = await fetch(
  "https://app.tireweblibrary.com/api/v1/vehicle/lookup",
  { headers: { "x-api-key": "tl_live_your_key" } }
);
const years = await response.json();

import requests

response = requests.get(
    "https://app.tireweblibrary.com/api/v1/vehicle/lookup",
    headers={"x-api-key": "tl_live_your_key"},
)
years = response.json()

Step 2 — Get makes for a year:

curl -H "x-api-key: tl_live_your_key" \
  "https://app.tireweblibrary.com/api/v1/vehicle/lookup?year=2024"

const response = await fetch(
  "https://app.tireweblibrary.com/api/v1/vehicle/lookup?year=2024",
  { headers: { "x-api-key": "tl_live_your_key" } }
);
const data = await response.json();

import requests

response = requests.get(
    "https://app.tireweblibrary.com/api/v1/vehicle/lookup",
    params={"year": "2024"},
    headers={"x-api-key": "tl_live_your_key"},
)
data = response.json()

Step 3 — Get fitments (full drill-down):

curl -H "x-api-key: tl_live_your_key" \
  "https://app.tireweblibrary.com/api/v1/vehicle/lookup?year=2024&make=Toyota&model=Camry&trim=SE"

const response = await fetch(
  "https://app.tireweblibrary.com/api/v1/vehicle/lookup?year=2024&make=Toyota&model=Camry&trim=SE",
  { headers: { "x-api-key": "tl_live_your_key" } }
);
const fitments = await response.json();

import requests

response = requests.get(
    "https://app.tireweblibrary.com/api/v1/vehicle/lookup",
    params={"year": "2024", "make": "Toyota", "model": "Camry", "trim": "SE"},
    headers={"x-api-key": "tl_live_your_key"},
)
fitments = response.json()

Response

{
  "endpoint": "year",
  "options": ["2024", "2023", "2022", "2021", "2020", "..."],
  "fitments": null
}

{
  "endpoint": "make",
  "options": ["Acura", "Audi", "BMW", "Buick", "Toyota", "..."],
  "fitments": null
}

{
  "endpoint": "fitment",
  "options": null,
  "fitments": [
    {
      "name": "225/65R17 102H",
      "position": "B",
      "width": "225",
      "aspect_ratio": "65",
      "rim_size": "17",
      "load_rating": "102",
      "speed_rating": "H"
    }
  ]
}

For staggered vehicles (different front and rear sizes) each axle is a separate row, with position "F" (front) and "R" (rear):

{
  "endpoint": "fitment",
  "options": null,
  "fitments": [
    {
      "name": "225/45R18 95Y",
      "position": "F",
      "width": "225",
      "aspect_ratio": "45",
      "rim_size": "18",
      "load_rating": "95",
      "speed_rating": "Y"
    },
    {
      "name": "255/40R18 99Y",
      "position": "R",
      "width": "255",
      "aspect_ratio": "40",
      "rim_size": "18",
      "load_rating": "99",
      "speed_rating": "Y"
    }
  ]
}

Response Fields

Error Responses

Related Endpoints

• Tires — search for specific tire sizes by dimensional attributes from the fitment results
• Tire Patterns — browse tire patterns for the makes and models found

Rebates

Browse available tire rebates and get detailed rebate information including line items and associated tire patterns.

List Rebates

List rebates with optional filters for date range, status, and make. Returns paginated results.

Query Parameters

Code Examples

curl -H "x-api-key: tl_live_your_key" \
  "https://app.tireweblibrary.com/api/v1/rebate?status=Active"

const response = await fetch(
  "https://app.tireweblibrary.com/api/v1/rebate?status=Active",
  { headers: { "x-api-key": "tl_live_your_key" } }
);
const data = await response.json();

import requests

response = requests.get(
    "https://app.tireweblibrary.com/api/v1/rebate",
    params={"status": "Active"},
    headers={"x-api-key": "tl_live_your_key"},
)
data = response.json()

Response

{
  "current_page": 1,
  "data": [
    {
      "id": 10,
      "name": "Spring Rebate",
      "start_date": "2025-03-01",
      "end_date": "2025-05-31",
      "global": true,
      "status": "Active"
    }
  ],
  "from": 1,
  "last_page": 1,
  "per_page": 30,
  "to": 12,
  "total": 12
}

Response Fields

Error Responses

Related Endpoints

• Tire Makes — get make names for the make_name filter
• Tire Patterns — browse patterns associated with rebate line items

Get Rebate by ID

Get full detail for a single rebate including line items (amounts, quantities, spend requirements) and associated tire patterns.

Path Parameters

Code Examples

curl -H "x-api-key: tl_live_your_key" \
  "https://app.tireweblibrary.com/api/v1/rebate/10"

const response = await fetch(
  "https://app.tireweblibrary.com/api/v1/rebate/10",
  { headers: { "x-api-key": "tl_live_your_key" } }
);
const rebate = await response.json();

import requests

response = requests.get(
    "https://app.tireweblibrary.com/api/v1/rebate/10",
    headers={"x-api-key": "tl_live_your_key"},
)
rebate = response.json()

Response

{
  "id": 10,
  "name": "Spring Rebate",
  "description": "Save on select tires this spring.",
  "image_url": "https://...",
  "image_horizontal_url": "https://...",
  "image_preview_url": "https://...",
  "form_url": "https://...",
  "start_date": "2025-03-01",
  "end_date": "2025-05-31",
  "global": true,
  "status": "Active",
  "rebate_items": [
    {
      "id": 25,
      "amount": 70.00,
      "amount_reason": "Prepaid Card",
      "amount_two": 100.00,
      "amount_two_reason": "Prepaid Card (select sizes)",
      "quantity_required": 4,
      "quantity_limit": null,
      "spend_min": null,
      "spend_max": null,
      "tire_patterns": [
        {
          "id": 678,
          "name": "Defender T+H",
          "description": "All-season tire...",
          "image_url": "https://..."
        }
      ]
    }
  ]
}

Response Fields

Error Responses

Related Endpoints

• Tire Patterns — get full pattern details for the tire patterns in rebate_items[].tire_patterns
• Tires — search for tire sizes that qualify for a rebate
• Tire Makes — filter rebates by make_name on the list endpoint

MCP Server (AI Assistants)

Connect AI assistants like Claude directly to the Tire Library catalog using the Model Context Protocol (MCP) — an open standard that lets AI tools query data through natural conversation. Instead of writing code against the REST API, you ask questions: “Find 205/55R16 winter tires from Michelin” or “What rebates are active right now?” — and the assistant calls the catalog for you.

MCP or REST API — which should I use?

Requirements

• An account with an active API membership subscription (the same tier that unlocks tl_live_ API keys). If you can use the REST API, you can use the MCP server.
• An MCP-compatible client: Claude.ai, Claude Desktop, ChatGPT, or any other MCP client.

Connection Details

Connect in Claude.ai

1. Go to Settings → Connectors → Add custom connector.
2. Enter the server URL: https://mcp.tireweblibrary.com/sse
3. Click Connect. A browser window opens to our sign-in page.
4. Sign in with your Tire Library account credentials.
5. Done — Claude can now query the tire catalog on your behalf.

Available Tools

The server exposes 17 read-only tools. Required parameters are marked with *. All tools return JSON; search/list tools return the same paged result shape as the REST catalog endpoints (results.current_page, results.data, etc.). On failure, tools return an error object ({"error": "...", "tool": "...", ...}) instead of throwing.

Example Prompts

• “List all tire makes and show me Michelin’s winter patterns” — list_tire_makes, list_tire_patterns_by_make
• “What fits a 2021 Ford F-150 XLT?” — check_fitment
• “Are there any active rebates on the Michelin CrossClimate 2?” — browse_tire_patterns, get_rebates_for_pattern
• “Does the Defender come in 225/65R17?” — search_sizes_in_pattern

Rate Limits

There is no separate MCP quota. Every tool call is forwarded to the REST API, where the standard limit applies: 100 requests per 60-second sliding window per company (shared across all API keys) under the API tier policy. Most tools translate to a single REST request per call; compare_tires makes one request per tire ID (2–6). If the limit is exceeded, the tool returns an error object with status: 429 — slow down and retry.

Notes

• The data is identical to what the REST API serves — MCP is just a conversation-friendly way to reach it.
• Access is read-only: the assistant can search and view catalog data but cannot modify anything.
• Sign-in sessions renew silently while in use; after ~7 days of inactivity the assistant will ask you to sign in again (see the callout at the top of this page).