Api documentation

Api documentation

Get A List of Model Years

Spec Model/Year
 
 
v3 v2
 
 

Sample Request

Get a list of model years for Honda Accord.

URL

  1. https://api.edmunds.com/api/vehicle/v3/modelYears?api_key={api key}&makeNiceName=honda&modelNiceName=accord

Response

  1. {
  2. "totalNumber": 32,
  3. "totalPages": 4,
  4. "results": [
  5. {
  6. "id": 100537089,
  7. "makeId": 200001444,
  8. "makeName": "Honda",
  9. "makeNiceName": "honda",
  10. "makeNiceId": "honda",
  11. "modelId": "Honda_Accord",
  12. "modelName": "Accord",
  13. "modelNiceName": "accord",
  14. "modelNiceId": "accord",
  15. "modelLinkCode": "M030277",
  16. "styles": [
  17. {
  18. "id": 101403692,
  19. "href": "/api/vehicle/v3/styles?id=101403692"
  20. },
  21. ...
  22. ],
  23. "newDefaultStyle": {
  24. "id": 101403689,
  25. "href": "/api/vehicle/v3/styles?id=101403689"
  26. },
  27. "usedDefaultStyle": {
  28. "id": 101403689,
  29. "href": "/api/vehicle/v3/styles?id=101403689"
  30. },
  31. "submodels": [
  32. {
  33. "id": 200410623,
  34. "name": "Accord Coupe",
  35. "niceId": "coupe",
  36. "identifier": "Coupe",
  37. "ruleType": "body",
  38. },
  39. ...
  40. ],
  41. "newDefaultSubmodel": {
  42. "id": 200410622,
  43. "name": "Accord Sedan",
  44. "niceId": "sedan",
  45. "identifier": "Sedan",
  46. "ruleType": "body",
  47. },
  48. "usedDefaultSubmodel": {
  49. "id": 200410622,
  50. "name": "Accord Sedan",
  51. "niceId": "sedan",
  52. "identifier": "Sedan",
  53. "ruleType": "body",
  54. },
  55. "midYear": false,
  56. "year": 2012,
  57. "model": {
  58. "id": "Honda_Accord",
  59. "name": "Accord",
  60. "niceName": "accord",
  61. "href": "/api/vehicle/v3/models?id=Honda_Accord"
  62. },
  63. "name": "2012",
  64. "attributeGroups": {
  65. "RELIABILITY_RATINGS": {
  66. "id": -100,
  67. "name": "RELIABILITY_RATINGS",
  68. "properties": {
  69. "FEATURES_AND_ACCESS_QUALITY_MECHANICAL": "5.0",
  70. ...
  71. },
  72. "attributes": {
  73. "FEATURES_AND_ACCESS_QUALITY_MECHANICAL": {
  74. "id": 0,
  75. "name": "FEATURES_AND_ACCESS_QUALITY_MECHANICAL",
  76. "value": "5.0"
  77. },
  78. ...
  79. },
  80. ...
  81. }
  82. },
  83. "categories": {
  84. "Vehicle Style": [
  85. "Coupe",
  86. "Sedan"
  87. ],
  88. "Market": [
  89. "N/A",
  90. "Performance"
  91. ],
  92. ...
  93. },
  94. "types": {
  95. "market": [
  96. "N/A",
  97. "Performance"
  98. ],
  99. ...
  100. },
  101. "categoryValues": [
  102. "N/A",
  103. "Car",
  104. "Coupe",
  105. "Midsize",
  106. "Performance",
  107. "Sedan"
  108. ],
  109. "publicationStates": [
  110. "USED"
  111. ],
  112. "minBaseMSRP": 21480.0,
  113. "tmvCorePercents": [ ],
  114. "edTypeCategories": [
  115. {
  116. "id": 2,
  117. "name": "Coupe",
  118. "slug": "coupe"
  119. },
  120. ...
  121. ]
  122. },
  123. ...
  124. ]
  125. }