Api documentation

Api documentation

Get details for a specific car make/brand

Spec: Make
 
 
v3 v2
 
 

Sample Request 1

Get the list of models and model/year IDs for NEW Lexus cars

URL

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

Response

  1. {
  2. "id": 200001623,
  3. "models":[{
  4. "id": "Lexus_CT_200h",
  5. "name": "CT 200h",
  6. "niceName": "ct200h",
  7. "years":[{
  8. "id": 100531231,
  9. "year": 2011
  10. },
  11. ....
  12. {
  13. "id": 100537990,
  14. "year": 2012
  15. }]
  16. },
  17. ....
  18. {
  19. "id": "Lexus_ES_250",
  20. "name": "ES 250",
  21. "niceName": "es250",
  22. "years": [{
  23. "id": 2029,
  24. "year": 1990
  25. },
  26. ....
  27. {
  28. "id": 2030,
  29. "year": 1991
  30. }]
  31. }],
  32. "name": "Lexus",
  33. "niceName": "lexus"
  34. }

Sample Request 2

Get the list of models and model/year IDs and their states (i.e. new, used, future) for NEW Lexus cars

URL

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

Response

  1. {
  2. "id": 200001623,
  3. "name": "Lexus",
  4. "niceName": "lexus",
  5. "models":[
  6. {
  7. "id": "Lexus_CT_200h",
  8. "name": "CT 200h",
  9. "niceName": "ct200h",
  10. "years":[
  11. {
  12. "id": 200437666,
  13. "year": 2013,
  14. "states": ["NEW"]
  15. },
  16. ...
  17. {
  18. "id": 100537990,
  19. "year": 2012,
  20. "states": ["USED"]
  21. }
  22. ],
  23. "states":["USED", "NEW"]
  24. },
  25. ...
  26. {
  27. "id": "Lexus_ES_350",
  28. "name": "ES 350",
  29. "niceName": "es350",
  30. "years": [
  31. {
  32. "id": 2013,
  33. "year": 100539469,
  34. "states":["USED", "NEW"]
  35. }
  36. ],
  37. "states":["USED", "NEW"]
  38. }
  39. ]
  40. }