> ## Documentation Index
> Fetch the complete documentation index at: https://api-docs.hrizn.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Compare trims

> Side-by-side trim comparison for one model year

Compares the trims of one model year from the Hrizn vehicle catalog: the trim list with MSRPs, plus per-category comparison tables (each with its own headers) and the features every trim shares.

**Scope required:** `inventory:read`

## Query parameters

<ParamField query="year" type="integer" required>Model year.</ParamField>
<ParamField query="make" type="string" required>Make name.</ParamField>
<ParamField query="model" type="string" required>Model name.</ParamField>

## Response

<ResponseField name="coverage" type="string">`available` (tables and trims), `trims_only` (trim list without tables), or `catalog_unavailable` (the model exists but holds no assembled facts yet).</ResponseField>
<ResponseField name="trims" type="object[]">Each trim's `name`, `msrp`, `description`, and display `position`.</ResponseField>
<ResponseField name="comparison_tables" type="object[]">One table per category with `headers`, per-feature `rows` (one value per trim), and `shared` features every trim has.</ResponseField>
