Api documentation

Api documentation

Get Model Year and Style Details for a Car Make and Model

Spec: Model
 
 
v3 v2
 
 

Sample Request 1

Get the list of model years and styles for used Honda Civics.

URL

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

Response

  1. {
  2. "id": "Honda_Civic",
  3. "name": "Civic",
  4. "niceName": "civic",
  5. "years": [
  6. {
  7. "id": 2148,
  8. "year": 1990,
  9. "styles": [
  10. {
  11. "id": 3883,
  12. "name": "2dr Hatchback",
  13. "submodel": {
  14. "body": "Hatchback",
  15. "modelName": "Civic Hatchback",
  16. "niceName": "hatchback"
  17. },
  18. "trim": "Base"
  19. },
  20. {
  21. "id": 3870,
  22. "name": "DX 2dr Hatchback",
  23. "submodel": {
  24. "body": "Hatchback",
  25. "modelName": "Civic Hatchback",
  26. "niceName": "hatchback"
  27. },
  28. "trim": "DX"
  29. },
  30. ...
  31. {
  32. "id": 3878,
  33. "name": "LX 4dr Sedan",
  34. "submodel": {
  35. "body": "Sedan",
  36. "modelName": "Civic Sedan",
  37. "niceName": "sedan"
  38. },
  39. "trim": "LX"
  40. }
  41. ]
  42. },
  43. ...
  44. {
  45. "id": 100505002,
  46. "year": 2005,
  47. "styles": [
  48. {
  49. "id": 100474733,
  50. "name": "Si 2dr Hatchback (2.0L 4cyl 5M)",
  51. "submodel": {
  52. "body": "Hatchback",
  53. "modelName": "Civic Hatchback",
  54. "niceName": "hatchback"
  55. },
  56. "trim": "Si"
  57. },
  58. ...
  59. {
  60. "id": 100526209,
  61. "name": "LX Special Edition 4dr Sedan (1.7L 4cyl 4A)",
  62. "submodel": {
  63. "body": "Sedan",
  64. "modelName": "Civic Sedan",
  65. "niceName": "sedan"
  66. },
  67. "trim": "LX Special Edition"
  68. }
  69. ]
  70. }
  71. ]
  72. }

Sample Request 2

Get the list of model year and style details and their states (i.e. new, used, future) for 2013 BMW X5

URL

  1. https://api.edmunds.com/api/vehicle/v2/bmw/x5?year=2013&view=full&fmt=json&api_key={api key}

Response

  1. {
  2. "id": "BMW_X5",
  3. "name": "X5",
  4. "niceName": "x5",
  5. "make": {
  6. "id": 200000081,
  7. "name": "BMW",
  8. "niceName": "bmw"
  9. },
  10. "years": [
  11. {
  12. "id": 200420450,
  13. "year": 2013,
  14. "styles": [
  15. {
  16. "id": 200420451,
  17. "name": "xDrive35i 4dr SUV AWD (3.0L 6cyl Turbo 8A)",
  18. "submodel": {
  19. "body": "SUV",
  20. "modelName": "X5 SUV",
  21. "niceName": "suv"
  22. },
  23. "trim": "xDrive35i",
  24. "states": [
  25. "USED",
  26. "NEW"
  27. ]
  28. },
  29. {
  30. "id": 200445599,
  31. "name": "xDrive35d 4dr SUV AWD (3.0L 6cyl Turbodiesel 6A)",
  32. "submodel": {
  33. "body": "SUV",
  34. "modelName": "X5 SUV Diesel",
  35. "fuel": "Diesel",
  36. "niceName": "diesel"
  37. },
  38. "trim": "xDrive35d",
  39. "states": [
  40. "USED",
  41. "NEW"
  42. ]
  43. },
  44. {
  45. "id": 200420452,
  46. "name": "xDrive35i Premium 4dr SUV AWD (3.0L 6cyl Turbo 8A)",
  47. "submodel": {
  48. "body": "SUV",
  49. "modelName": "X5 SUV",
  50. "niceName": "suv"
  51. },
  52. "trim": "xDrive35i Premium",
  53. "states": [
  54. "USED",
  55. "NEW"
  56. ]
  57. },
  58. {
  59. "id": 200420453,
  60. "name": "xDrive35i Sport Activity 4dr SUV AWD (3.0L 6cyl Turbo 8A)",
  61. "submodel": {
  62. "body": "SUV",
  63. "modelName": "X5 SUV",
  64. "niceName": "suv"
  65. },
  66. "trim": "xDrive35i Sport Activity",
  67. "states": [
  68. "USED",
  69. "NEW"
  70. ]
  71. },
  72. {
  73. "id": 200420454,
  74. "name": "xDrive50i 4dr SUV AWD (4.4L 8cyl Turbo 8A)",
  75. "submodel": {
  76. "body": "SUV",
  77. "modelName": "X5 SUV",
  78. "niceName": "suv"
  79. },
  80. "trim": "xDrive50i",
  81. "states": [
  82. "USED",
  83. "NEW"
  84. ]
  85. }
  86. ],
  87. "states": [
  88. "NEW",
  89. "USED"
  90. ]
  91. }
  92. ],
  93. "states": [
  94. "NEW",
  95. "FUTURE",
  96. "USED"
  97. ]
  98. }