---
title: "Get computed geometry, population stats, and hints for a wheel/tire spec"
method: GET
path: "/v2/spec/metadata/"
tags: ["Spec"]
---

# Get computed geometry, population stats, and hints for a wheel/tire spec

`GET /v2/spec/metadata/`

Returns computed geometry (frontspace, backspace, weight estimate), database population statistics (offset distribution, percentiles, match estimates), and contextual hints for a given rim and/or tire specification.

**Modes** (auto-detected from parameters):
- **rim** — `rim_diameter` + `rim_width` (optionally `rim_offset`)
- **tire** — `section_width` + `aspect_ratio` + `rim_diameter`
- **hf_tire** — `overall_diameter` + `section_width` + `rim_diameter`
- **package** — rim + tire params combined

Use this endpoint before search or classified calls to understand whether a spec is common or unusual, what tolerances to use, and what to expect from results.

## Query parameters

- `rim_diameter` number, double
- `rim_width` number, double
- `rim_offset` number, double
- `bolt_pattern` string
- `cb` number, double
- `section_width` number, double
- `aspect_ratio` integer
- `overall_diameter` number, double
- `hints` boolean

## Response `200`

- SpecMetadataOutput — Minimal serializer to satisfy drf_yasg schema introspection. Actual response is a plain dict built by SpecMetadataReport.processing().
  - `mode` string, required — Detected mode: rim, tire, hf_tire, or package

---

[API](https://skmtc.dev/wheel-size/apis/wheel-fitment-api.md) · [All operations](https://skmtc.dev/wheel-size/apis/wheel-fitment-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/wheel-size/wheel-fitment-api/revisions/8b6863e8004e/schema)
