# Edmunds Model Years API Documentation

List every submodel (for example Sedan or Wagon) of one car model with all its model years. Each year has the default style id, which you can use for the TMV endpoints, and the new and used starting prices when Edmunds has them. An unknown make or model returns a not-billable 404.

- **Documentation:** [https://scrappa.co/docs/edmunds-api/edmunds_catalog_model_years](https://scrappa.co/docs/edmunds-api/edmunds_catalog_model_years)
- **API group:** Edmunds API
- **Endpoint:** `GET https://scrappa.co/api/edmunds/catalog/model-years`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `make` | string | Yes | Make slug in lowercase, from the makes endpoint. Example: toyota. |
| `model` | string | Yes | Model slug in lowercase. Example: camry. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/edmunds/catalog/model-years?make=toyota&model=camry"
```

## Example response

```json
{
    "success": true,
    "data": {
        "make": "toyota",
        "model": "camry",
        "submodels": [
            {
                "slug": "sedan",
                "name": "Camry Sedan",
                "years": [
                    {
                        "year": 2024,
                        "default_style_id": "401999975"
                    },
                    {
                        "year": 2025,
                        "default_style_id": "402033137",
                        "new_price": 33279
                    },
                    {
                        "year": 2026,
                        "default_style_id": "402082427",
                        "new_price": 33908
                    }
                ]
            },
            {
                "slug": "wagon",
                "name": "Camry Wagon",
                "years": [
                    {
                        "year": 1995,
                        "default_style_id": "4291",
                        "used_price": 1507.138
                    },
                    {
                        "year": 1996,
                        "default_style_id": "12002",
                        "used_price": 1511.608
                    }
                ]
            }
        ]
    },
    "meta": {
        "endpoint_family": "catalog_model_years",
        "billable": true
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A required query parameter is missing or invalid. This response is not billable. |
| 404 | Resource Not Found | The requested Edmunds resource does not exist. This response is not billable. |
| 503 | Invalid Source Response | The upstream answered with a shape that no longer matches the documented contract. This response is not billable. |
| 503 | Service Unavailable | The upstream service is temporarily unavailable. Please retry shortly. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)