Api documentation

Api documentation

Get a List of Car Model Years for a Specific Car Make/Model

Spec Model/Year
 
 
v2 v1
 
 

Sample Request 1

Get the list of model years and their styles and trims for all new Honda Civics.

URL

https://api.edmunds.com/api/vehicle/v2/honda/civic?fmt=json&state=new&api_key={api key}

Response

{
  "years": [
    {
      "id": 200442557,
      "year": 2013,
      "styles": [
        {
          "id": 200443845,
          "name": "LX 2dr Coupe (1.8L 4cyl 5A)",
          "submodel": {
            "body": "Coupe",
            "modelName": "Civic Coupe",
            "niceName": "coupe"
          },
          "trim": "LX"
        },
        ...
        {
          "id": 200463193,
          "name": "HF PZEV 4dr Sedan (1.8L 4cyl 5A)",
          "submodel": {
            "body": "Sedan",
            "modelName": "Civic Sedan",
            "niceName": "sedan"
          },
          "trim": "HF PZEV"
        }
      ]
    }
  ]
}

Sample Request 2

Get the list of model years and their styles and trims for all New Honda Civics with view=full

URL

https://api.edmunds.com/api/vehicle/v2/honda/civic?fmt=json&view=full&state=new&api_key={api key}

Response

{
  "id": 200442557,
  "name": "Civic",
  "niceName": "civic",
  "make": {
     "id": 200001444,
     "name": "Honda",
     "niceName": "honda"
  },
  "years": [
    {
      "id": 200442557,
      "year": 2013,
      "styles": [
        {
          "id": 200443845,
          "name": "LX 2dr Coupe (1.8L 4cyl 5A)",
          "submodel": {
            "body": "Coupe",
            "modelName": "Civic Coupe",
            "niceName": "coupe"
          },
          "trim": "LX",
          "states": [
            "USED",
            "NEW"
          ]
        },
        {
          "id": 200443846,
          "name": "LX 2dr Coupe (1.8L 4cyl 5M)",
          "submodel": {
            "body": "Coupe",
            "modelName": "Civic Coupe",
            "niceName": "coupe"
          },
          "trim": "LX",
          "states": [
            "USED",
            "NEW"
          ]
        },
        ...
        {
          "id": 200463193,
          "name": "HF PZEV 4dr Sedan (1.8L 4cyl 5A)",
          "submodel": {
            "body": "Sedan",
            "modelName": "Civic Sedan",
            "niceName": "sedan"
          },
          "trim": "HF PZEV",
          "states": [
            "USED",
            "NEW"
          ]
        }
      ],
      "states": [
        "USED",
        "NEW"
      ]
    }
  ],
  "states": [
    "USED",
    "NEW"
  ]
}