{"components":{"schemas":{"Car":{"properties":{"brand":{"type":"string"},"bslug":{"type":"string"},"model":{"type":"string"},"mslug":{"type":"string"},"variant":{"nullable":true,"type":"string"}},"type":"object"},"Catalog":{"oneOf":[{"properties":{"brands":{"items":{"properties":{"brand":{"type":"string"},"bslug":{"type":"string"},"models_count":{"type":"integer"}},"type":"object"},"type":"array"}},"required":["brands"],"type":"object"},{"properties":{"brand":{"type":"string"},"bslug":{"type":"string"},"models":{"items":{"properties":{"model":{"type":"string"},"mslug":{"type":"string"}},"type":"object"},"type":"array"}},"required":["brand","bslug","models"],"type":"object"}]},"Configuration":{"description":"Effective catalog/manual configuration. Additional source and compatibility fields may be present. Square ET corrections are reflected in grouped.wdetail, while these raw rows retain source ET.","properties":{"cb":{"description":"Numeric specification encoded as text, in catalog units.","type":"string"},"cb_fit_front":{"type":"string"},"cb_fit_rear":{"type":"string"},"cb_front":{"description":"Numeric specification encoded as text, in catalog units.","type":"string"},"cb_rear":{"description":"Numeric specification encoded as text, in catalog units.","type":"string"},"combination":{"type":"string"},"config_key":{"type":"string"},"et_front":{"description":"Numeric specification encoded as text, in catalog units.","type":"string"},"et_rear":{"description":"Numeric specification encoded as text, in catalog units.","type":"string"},"manual":{"type":"boolean"},"pcd":{"type":"string"},"size":{"description":"Numeric specification encoded as text, in catalog units.","type":"string"},"size_front":{"description":"Numeric specification encoded as text, in catalog units.","type":"string"},"size_rear":{"description":"Numeric specification encoded as text, in catalog units.","type":"string"},"width_front":{"description":"Numeric specification encoded as text, in catalog units.","type":"string"},"width_rear":{"description":"Numeric specification encoded as text, in catalog units.","type":"string"}},"type":"object"},"Error":{"properties":{"error":{"type":"string"},"max_ips":{"type":"integer"},"parameter":{"type":"string"},"results":{"items":{"type":"object"},"type":"array"}},"type":"object"},"Fitment":{"properties":{"car":{"$ref":"#/components/schemas/Car"},"effective_configs":{"items":{"$ref":"#/components/schemas/Configuration"},"type":"array"},"grouped":{"items":{"$ref":"#/components/schemas/SquareGroup"},"type":"array"},"hidden_cb":{"type":"integer"},"hidden_count":{"type":"integer"},"native_cb":{"nullable":true,"type":"string"},"native_cb_front":{"nullable":true,"type":"string"},"native_cb_rear":{"nullable":true,"type":"string"},"native_pcds":{"items":{"type":"string"},"type":"array"},"staggered":{"items":{"$ref":"#/components/schemas/StaggeredGroup"},"type":"array"}},"type":"object"},"SquareGroup":{"properties":{"count":{"type":"integer"},"et_range":{"type":"string"},"native_cb":{"nullable":true,"type":"string"},"pcd":{"type":"string"},"ring_cbs":{"items":{"description":"Numeric specification encoded as text, in catalog units.","type":"string"},"type":"array"},"size":{"description":"Numeric specification encoded as text, in catalog units.","type":"string"},"wdetail":{"items":{"$ref":"#/components/schemas/WidthDetail"},"type":"array"},"width_range":{"type":"string"}},"type":"object"},"StaggeredGroup":{"properties":{"count":{"type":"integer"},"ef_range":{"type":"string"},"er_range":{"type":"string"},"native_cb":{"nullable":true,"type":"string"},"native_cb_front":{"nullable":true,"type":"string"},"native_cb_rear":{"nullable":true,"type":"string"},"pairs":{"items":{"$ref":"#/components/schemas/Configuration"},"type":"array"},"pcd":{"type":"string"},"size":{"description":"Numeric specification encoded as text, in catalog units.","type":"string"},"size_front":{"description":"Numeric specification encoded as text, in catalog units.","type":"string"},"size_rear":{"description":"Numeric specification encoded as text, in catalog units.","type":"string"},"wf_range":{"type":"string"},"wr_range":{"type":"string"}},"type":"object"},"WheelMatches":{"properties":{"results":{"items":{"properties":{"brand":{"type":"string"},"cars":{"items":{"properties":{"bslug":{"type":"string"},"model":{"type":"string"},"mslug":{"type":"string"}},"type":"object"},"type":"array"}},"type":"object"},"type":"array"}},"type":"object"},"WidthDetail":{"properties":{"donors":{"type":"integer"},"et_range":{"description":"Formatted effective range such as 20\u201335, \u226435, \u226520 or 30. Parse explicitly.","type":"string"},"is_gold":{"type":"boolean"},"width":{"description":"Numeric specification encoded as text, in catalog units.","type":"string"}},"type":"object"}},"securitySchemes":{"ApiKey":{"in":"header","name":"X-API-Key","type":"apiKey"},"BearerKey":{"description":"Use the company API key as bearer token.","scheme":"bearer","type":"http"}}},"info":{"description":"Company-managed access to vehicle catalogs and wheel compatibility lookups. Access, IP allowances and quotas are configured by the administrator. Catalog specification fields are commonly strings. Physical fitment factors beyond these parameters require separate verification.","title":"FitmentCore wheel fitment API","version":"1.0"},"openapi":"3.0.3","paths":{"/api/v1/cars":{"get":{"description":"Omit brand for all makes; supply a catalog name or slug for its complete, deduplicated model list.","parameters":[{"description":"Catalog brand name or slug. An empty string is invalid.","in":"query","name":"brand","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Catalog"}}},"description":"Successful lookup. Empty matches are a valid result.","headers":{"X-RateLimit-Limit":{"description":"Quota limit for the reported window.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Remaining requests in the reported window.","schema":{"type":"integer"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid query","headers":{"X-RateLimit-Limit":{"description":"Quota limit for the reported window.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Remaining requests in the reported window.","schema":{"type":"integer"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid API key","headers":{"X-RateLimit-Limit":{"description":"Quota limit for the reported window.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Remaining requests in the reported window.","schema":{"type":"integer"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Account, expiry or IP allowance blocks access","headers":{"X-RateLimit-Limit":{"description":"Quota limit for the reported window.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Remaining requests in the reported window.","schema":{"type":"integer"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unknown catalog vehicle, brand or variant","headers":{"X-RateLimit-Limit":{"description":"Quota limit for the reported window.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Remaining requests in the reported window.","schema":{"type":"integer"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Quota exceeded; respect Retry-After","headers":{"Retry-After":{"description":"Seconds until retry.","schema":{"type":"integer"}},"X-RateLimit-Limit":{"description":"Quota limit for the reported window.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Remaining requests in the reported window.","schema":{"type":"integer"}}}}},"security":[{"ApiKey":[]},{"BearerKey":[]}],"summary":"List makes or models"}},"/api/v1/fitments/by-car":{"get":{"description":"Supply brand and model together OR bslug and mslug together. An optional variant selects an existing configured variant. Manual corrections are included.","parameters":[{"description":"Exact catalog make; required with model when slugs are not supplied.","in":"query","name":"brand","required":false,"schema":{"type":"string"}},{"description":"Exact catalog generation/year entry.","in":"query","name":"model","required":false,"schema":{"type":"string"}},{"description":"Make slug from /api/v1/cars.","in":"query","name":"bslug","required":false,"schema":{"type":"string"}},{"description":"Model slug from /api/v1/cars.","in":"query","name":"mslug","required":false,"schema":{"type":"string"}},{"description":"Optional configured variant slug.","in":"query","name":"variant","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Fitment"}}},"description":"Successful lookup. Empty matches are a valid result.","headers":{"X-RateLimit-Limit":{"description":"Quota limit for the reported window.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Remaining requests in the reported window.","schema":{"type":"integer"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid query","headers":{"X-RateLimit-Limit":{"description":"Quota limit for the reported window.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Remaining requests in the reported window.","schema":{"type":"integer"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid API key","headers":{"X-RateLimit-Limit":{"description":"Quota limit for the reported window.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Remaining requests in the reported window.","schema":{"type":"integer"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Account, expiry or IP allowance blocks access","headers":{"X-RateLimit-Limit":{"description":"Quota limit for the reported window.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Remaining requests in the reported window.","schema":{"type":"integer"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unknown catalog vehicle, brand or variant","headers":{"X-RateLimit-Limit":{"description":"Quota limit for the reported window.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Remaining requests in the reported window.","schema":{"type":"integer"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Quota exceeded; respect Retry-After","headers":{"Retry-After":{"description":"Seconds until retry.","schema":{"type":"integer"}},"X-RateLimit-Limit":{"description":"Quota limit for the reported window.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Remaining requests in the reported window.","schema":{"type":"integer"}}}}},"security":[{"ApiKey":[]},{"BearerKey":[]}],"summary":"Get wheel fitments for a vehicle"}},"/api/v1/fitments/by-wheel":{"get":{"description":"PCD and diameter (or size alias) are required. Both axles are checked for staggered setups. Rear-only parameters are rejected in one mode. The bore comparison allows a 0.25 mm catalog-precision tolerance.","parameters":[{"description":"Bolt pattern, e.g. 5x112.","in":"query","name":"pcd","required":true,"schema":{"type":"string"}},{"description":"Front wheel diameter in inches. Required unless the size alias is supplied.","in":"query","name":"diameter","required":false,"schema":{"type":"number"}},{"description":"Alias of diameter.","in":"query","name":"size","required":false,"schema":{"type":"number"}},{"description":"one for square wheels; stag for a front/rear pair. Defaults to one.","in":"query","name":"mode","required":false,"schema":{"type":"string"}},{"description":"Square wheel width (inches); matching tolerance \u00b10.5 inches.","in":"query","name":"width","required":false,"schema":{"type":"number"}},{"description":"Square wheel offset (mm); matching tolerance \u00b12 mm.","in":"query","name":"et","required":false,"schema":{"type":"number"}},{"description":"Front wheel bore DIA (mm). In one mode it must fit both axle hubs.","in":"query","name":"cb","required":false,"schema":{"type":"number"}},{"description":"Front width for mode=stag (inches).","in":"query","name":"wf","required":false,"schema":{"type":"number"}},{"description":"Front offset for mode=stag (mm).","in":"query","name":"ef","required":false,"schema":{"type":"number"}},{"description":"Rear width for mode=stag (inches).","in":"query","name":"wr","required":false,"schema":{"type":"number"}},{"description":"Rear offset for mode=stag (mm).","in":"query","name":"er","required":false,"schema":{"type":"number"}},{"description":"Rear diameter for stag; defaults to front diameter.","in":"query","name":"diameter_rear","required":false,"schema":{"type":"number"}},{"description":"Alias of diameter_rear.","in":"query","name":"size_rear","required":false,"schema":{"type":"number"}},{"description":"Rear bore for stag; defaults to cb. Not allowed for mode=one.","in":"query","name":"cb_rear","required":false,"schema":{"type":"number"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WheelMatches"}}},"description":"Successful lookup. Empty matches are a valid result.","headers":{"X-RateLimit-Limit":{"description":"Quota limit for the reported window.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Remaining requests in the reported window.","schema":{"type":"integer"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid query","headers":{"X-RateLimit-Limit":{"description":"Quota limit for the reported window.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Remaining requests in the reported window.","schema":{"type":"integer"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid API key","headers":{"X-RateLimit-Limit":{"description":"Quota limit for the reported window.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Remaining requests in the reported window.","schema":{"type":"integer"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Account, expiry or IP allowance blocks access","headers":{"X-RateLimit-Limit":{"description":"Quota limit for the reported window.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Remaining requests in the reported window.","schema":{"type":"integer"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unknown catalog vehicle, brand or variant","headers":{"X-RateLimit-Limit":{"description":"Quota limit for the reported window.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Remaining requests in the reported window.","schema":{"type":"integer"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Quota exceeded; respect Retry-After","headers":{"Retry-After":{"description":"Seconds until retry.","schema":{"type":"integer"}},"X-RateLimit-Limit":{"description":"Quota limit for the reported window.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Remaining requests in the reported window.","schema":{"type":"integer"}}}}},"security":[{"ApiKey":[]},{"BearerKey":[]}],"summary":"Find vehicles by wheel parameters"}}},"servers":[{"url":"https://fitmentcore.com"}]}