Get started

Api documentation

Api documentation

Get list of car makes

Spec: Make
 
 
v3 v2
 
 
Overview  
api/vehicle/v2/makes 
 
 

Sample Request 1

Get the list of all new car makes with view=full

URL

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

Response

  1. {
  2.    "makes":[
  3.       {
  4.          "id":200002038,
  5.          "name":"Acura",
  6.          "niceName":"acura",
  7.          "models":[
  8.             {
  9.                "id":"Acura_ILX",
  10.                "name":"ILX",
  11.                "niceName":"ilx",
  12.                "years":[
  13.                   {
  14.                      "id":100538929,
  15.                      "year":2013,
  16.                      "states":["USED","NEW"]
  17.                   },
  18.                   {
  19.                      "id":200471908,
  20.                      "year":2014,
  21.                      "states":["NEW"]
  22.                   }
  23.                ],
  24.                "states":["NEW","USED"]
  25.             },
  26.             ...
  27.             {
  28.                "id":"Acura_ZDX",
  29.                "name":"ZDX",
  30.                "niceName":"zdx",
  31.                "years":[
  32.                   {
  33.                      "id":100537249,
  34.                      "year":2012,
  35.                      "states":["USED","NEW"]
  36.                   },
  37.                   {
  38.                      "id":200441835,
  39.                      "year":2013,
  40.                      "states":["NEW"]
  41.                   }
  42.                ],
  43.                "states":["USED","NEW"]
  44.             }
  45.          ]
  46.       },
  47.       ...
  48.       {
  49.          "id":200010382,
  50.          "name":"Volvo",
  51.          "niceName":"volvo",
  52.          "models":[
  53.             {
  54.                "id":"Volvo_C30",
  55.                "name":"C30",
  56.                "niceName":"c30",
  57.                "years":[
  58.                   {
  59.                      "id":200425618,
  60.                      "year":2013,
  61.                      "states":["NEW"]
  62.                   }
  63.                ],
  64.                "states":["USED","NEW"]
  65.             },
  66.             ...
  67.             {
  68.                "id":"Volvo_XC90",
  69.                "name":"XC90",
  70.                "niceName":"xc90",
  71.                "years":[
  72.                   {
  73.                      "id":100539229,
  74.                      "year":2013,
  75.                      "states":["USED","NEW"]
  76.                   },
  77.                   {
  78.                      "id":200484498,
  79.                      "year":2014,
  80.                      "states":["NEW"]
  81.                   }
  82.                ],
  83.                "states":["USED","NEW"]
  84.             }
  85.          ]
  86.       },
  87.       {
  88.          "id":200038885,
  89.          "name":"smart",
  90.          "niceName":"smart",
  91.          "models":[
  92.             {
  93.                "id":"smart_fortwo",
  94.                "name":"fortwo",
  95.                "niceName":"fortwo",
  96.                "years":[
  97.                   {
  98.                      "id":200418482,
  99.                      "year":2013,
  100.                      "states":["NEW"]
  101.                   }
  102.                ],
  103.                "states":["USED","NEW"]
  104.             }
  105.          ]
  106.       }
  107.    ],
  108.    "makesCount":46
  109. }

Sample Request 2

Get the list of all new car makes

URL

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

Response

  1. {
  2.    "makes":[
  3.       {
  4.          "id":200002038,
  5.          "name":"Acura",
  6.          "niceName":"acura",
  7.          "models":[
  8.             {
  9.                "id":"Acura_ILX",
  10.                "name":"ILX",
  11.                "niceName":"ilx",
  12.                "years":[
  13.                   {
  14.                      "id":100538929,
  15.                      "year":2013
  16.                   },
  17.                   {
  18.                      "id":200471908,
  19.                      "year":2014
  20.                   }
  21.                ]
  22.             },
  23.             ...
  24.             {
  25.                "id":"Acura_ZDX",
  26.                "name":"ZDX",
  27.                "niceName":"zdx",
  28.                "years":[
  29.                   {
  30.                      "id":100537249,
  31.                      "year":2012
  32.                   },
  33.                   {
  34.                      "id":200441835,
  35.                      "year":2013
  36.                   }
  37.                ]
  38.             }
  39.          ]
  40.       },
  41.       ...
  42.       {
  43.          "id":200010382,
  44.          "name":"Volvo",
  45.          "niceName":"volvo",
  46.          "models":[
  47.             {
  48.                "id":"Volvo_C30",
  49.                "name":"C30",
  50.                "niceName":"c30",
  51.                "years":[
  52.                   {
  53.                      "id":200425618,
  54.                      "year":2013
  55.                   }
  56.                ]
  57.             },
  58.             ...
  59.             {
  60.                "id":"Volvo_XC90",
  61.                "name":"XC90",
  62.                "niceName":"xc90",
  63.                "years":[
  64.                   {
  65.                      "id":100539229,
  66.                      "year":2013
  67.                   },
  68.                   {
  69.                      "id":200484498,
  70.                      "year":2014
  71.                   }
  72.                ]
  73.             }
  74.          ]
  75.       },
  76.       {
  77.          "id":200038885,
  78.          "name":"smart",
  79.          "niceName":"smart",
  80.          "models":[
  81.             {
  82.                "id":"smart_fortwo",
  83.                "name":"fortwo",
  84.                "niceName":"fortwo",
  85.                "years":[
  86.                   {
  87.                      "id":200418482,
  88.                      "year":2013
  89.                   }
  90.                ]
  91.             }
  92.          ]
  93.       }
  94.    ],
  95.    "makesCount":46
  96. }
Previous Next