{
    "openapi": "3.0.3",
    "info": {
        "title": "ANKUSI Wheel Fitment API",
        "version": "2026.10",
        "description": "Free, open JSON API for wheel fitment data: bolt pattern (PCD), center bore, factory wheel size and offset, plus reference flush and maximum aftermarket sizes for about 10,000 vehicles. No API key. Data licensed CC BY 4.0.",
        "contact": {
            "name": "ANKUSI Wheels",
            "url": "https://ankusiwheels.com/wheel-fitment-api/",
            "email": "info@ankusi.com"
        },
        "license": {
            "name": "CC BY 4.0 (data)",
            "url": "https://creativecommons.org/licenses/by/4.0/"
        },
        "x-logo": {
            "url": "https://ankusiwheels.com/favicon.ico"
        }
    },
    "externalDocs": {
        "url": "https://ankusiwheels.com/wheel-fitment-api/"
    },
    "servers": [
        {
            "url": "https://ankusiwheels.com/wp-json/ankusi/v1"
        }
    ],
    "paths": {
        "/fitment": {
            "get": {
                "operationId": "listFitment",
                "summary": "Vehicles matching make, model, year or bolt pattern",
                "description": "At least one of make, model or bolt_pattern is required.",
                "parameters": [
                    {
                        "name": "make",
                        "in": "query",
                        "schema": {
                            "type": "string"
                        },
                        "example": "Toyota",
                        "description": "Exact make name, case-insensitive"
                    },
                    {
                        "name": "model",
                        "in": "query",
                        "schema": {
                            "type": "string"
                        },
                        "example": "Camry",
                        "description": "Part of the model name, case-insensitive"
                    },
                    {
                        "name": "year",
                        "in": "query",
                        "schema": {
                            "type": "string"
                        },
                        "example": "2019",
                        "description": "Exact model year"
                    },
                    {
                        "name": "bolt_pattern",
                        "in": "query",
                        "schema": {
                            "type": "string"
                        },
                        "example": "5x114.3",
                        "description": "Exact bolt pattern"
                    },
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 100,
                            "default": 25
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Matching vehicles",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "dataset_version": {
                                            "type": "string"
                                        },
                                        "license": {
                                            "type": "string"
                                        },
                                        "attribution": {
                                            "type": "string"
                                        },
                                        "doi": {
                                            "type": "string"
                                        },
                                        "count": {
                                            "type": "integer"
                                        },
                                        "results": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/Fitment"
                                            }
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "No make, model or bolt_pattern given"
                    }
                }
            }
        },
        "/makes": {
            "get": {
                "operationId": "listMakes",
                "summary": "All makes with the number of vehicles for each",
                "responses": {
                    "200": {
                        "description": "Makes",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "dataset_version": {
                                            "type": "string"
                                        },
                                        "license": {
                                            "type": "string"
                                        },
                                        "attribution": {
                                            "type": "string"
                                        },
                                        "doi": {
                                            "type": "string"
                                        },
                                        "count": {
                                            "type": "integer"
                                        },
                                        "results": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "make": {
                                                        "type": "string"
                                                    },
                                                    "vehicles": {
                                                        "type": "integer"
                                                    }
                                                }
                                            }
                                        }
                                    }
                                }
                            }
                        }
                    }
                }
            }
        },
        "/dataset/csv": {
            "get": {
                "operationId": "datasetCsv",
                "summary": "Full dataset as CSV",
                "responses": {
                    "200": {
                        "description": "CSV file",
                        "content": {
                            "text/csv": {
                                "schema": {
                                    "type": "string"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/dataset/json": {
            "get": {
                "operationId": "datasetJson",
                "summary": "Full dataset as JSON",
                "responses": {
                    "200": {
                        "description": "JSON dataset",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "Fitment": {
                "type": "object",
                "properties": {
                    "make": {
                        "type": "string"
                    },
                    "model": {
                        "type": "string"
                    },
                    "year": {
                        "type": "string"
                    },
                    "chassis_code": {
                        "type": "string"
                    },
                    "bolt_pattern": {
                        "type": "string",
                        "example": "5x120"
                    },
                    "lug_count": {
                        "type": "string"
                    },
                    "center_bore_mm": {
                        "type": "string"
                    },
                    "center_bore_rear_mm": {
                        "type": "string"
                    },
                    "oe_wheel": {
                        "type": "string"
                    },
                    "flush_wheel": {
                        "type": "string"
                    },
                    "max_wheel": {
                        "type": "string"
                    },
                    "source_url": {
                        "type": "string",
                        "format": "uri"
                    }
                }
            }
        }
    }
}