Api documentation

Api documentation

Find Inventories by ZIP

Vehicle Listings
 
 
v2 v1
 
 

Sample Request

Find inventories in the Santa Monica area (90404).

Basic request

URL

  1. https://api.edmunds.com/api/inventory/v2/inventories?zipcode=90404&fmt=json

Response

  1. {
  2. "inventories": [
  3. {
  4. "id": "0F0483EBB9EDF30081DBF3F5698CFEB8",
  5. "type": "NEW",
  6. "vin": "1C3CCCAB8FN559978",
  7. "stockNumber": "350175",
  8. "mileage": 16,
  9. "make": {
  10. "name": "Chrysler",
  11. "niceName": "chrysler"
  12. },
  13. "model": {
  14. "name": "200",
  15. "niceName": "200"
  16. },
  17. "year": {
  18. "id": 200490591,
  19. "year": 2015
  20. },
  21. "style": {
  22. "id": 200674795,
  23. "name": "Limited 4dr Sedan (2.4L 4cyl 9A)",
  24. "submodel": {
  25. "body": "Sedan",
  26. "modelName": "200 Sedan",
  27. "niceName": "sedan"
  28. },
  29. "trim": "Limited"
  30. },
  31. "media": {
  32. "photos": {
  33. "thumbnails": {
  34. "count": 2,
  35. "links": [
  36. {
  37. "rel": "_self",
  38. "href": "https://pictures.dealer.com/c/californiasuperstoresvalenciacllc/0209/c646513ccc02f8d1fb99db71bf9a363ex.jpg",
  39. "size": "LARGE"
  40. },
  41. {
  42. "rel": "_self",
  43. "href": "https://pictures.dealer.com/c/californiasuperstoresvalenciacllc/0209/c646513ccc02f8d1fb99db71bf9a363ex.jpg",
  44. "size": "MEDIUM"
  45. }
  46. ]
  47. }
  48. }
  49. },
  50. "prices": {
  51. "msrp": 25375,
  52. "tmv": 23814,
  53. "invoice": 1500
  54. },
  55. "dealer": {
  56. "dealerId": "1046",
  57. "name": "California Superstores Valencia",
  58. "address": {
  59. "street": "23820 Creekside Rd",
  60. "city": "Valencia",
  61. "stateCode": "CA",
  62. "stateName": "California",
  63. "county": "Los Angeles",
  64. "country": "USA",
  65. "latitude": 34.418535,
  66. "longitude": -118.552833,
  67. "zipcode": "91355"
  68. },
  69. "franchiseId": "649665",
  70. "premier": false
  71. }
  72. },
  73. ...
  74. {
  75. "id": "BCAB31729795ECEB6E982C88C74626C0",
  76. "type": "NEW",
  77. "vin": "1C3CCCAB9FN535057",
  78. "stockNumber": "350011",
  79. "mileage": 14,
  80. "make": {
  81. "name": "Chrysler",
  82. "niceName": "chrysler"
  83. },
  84. "model": {
  85. "name": "200",
  86. "niceName": "200"
  87. },
  88. "year": {
  89. "id": 200490591,
  90. "year": 2015
  91. },
  92. "style": {
  93. "id": 200674795,
  94. "name": "Limited 4dr Sedan (2.4L 4cyl 9A)",
  95. "submodel": {
  96. "body": "Sedan",
  97. "modelName": "200 Sedan",
  98. "niceName": "sedan"
  99. },
  100. "trim": "Limited"
  101. },
  102. "media": {
  103. "photos": {
  104. "thumbnails": {
  105. "count": 2,
  106. "links": [
  107. {
  108. "rel": "_self",
  109. "href": "https://pictures.dealer.com/c/californiasuperstoresvalenciacllc/0257/6fa45b963920bced0a1b3bce3c14c39cx.jpg",
  110. "size": "LARGE"
  111. },
  112. {
  113. "rel": "_self",
  114. "href": "https://pictures.dealer.com/c/californiasuperstoresvalenciacllc/0257/6fa45b963920bced0a1b3bce3c14c39cx.jpg",
  115. "size": "MEDIUM"
  116. }
  117. ]
  118. }
  119. }
  120. },
  121. "prices": {
  122. "msrp": 25740,
  123. "tmv": 24155,
  124. "guaranteedPrice": 1500
  125. },
  126. "dealer": {
  127. "dealerId": "1046",
  128. "name": "California Superstores Valencia",
  129. "address": {
  130. "street": "23820 Creekside Rd",
  131. "city": "Valencia",
  132. "stateCode": "CA",
  133. "stateName": "California",
  134. "county": "Los Angeles",
  135. "country": "USA",
  136. "latitude": 34.418535,
  137. "longitude": -118.552833,
  138. "zipcode": "91355"
  139. },
  140. "franchiseId": "649665",
  141. "premier": true
  142. }
  143. }
  144. ],
  145. "inventoriesCount": 132926,
  146. "links": [
  147. {
  148. "rel": "first",
  149. "href": "/api/inventory/v2/inventories?zipcode=90404&pagesize=10&pagenum=1&fmt=json"
  150. },
  151. {
  152. "rel": "next",
  153. "href": "/api/inventory/v2/inventories?zipcode=90404&pagesize=10&pagenum=2&fmt=json"
  154. },
  155. {
  156. "rel": "last",
  157. "href": "/api/inventory/v2/inventories?zipcode=90404&pagesize=10&pagenum=132926&fmt=json"
  158. }
  159. ]
  160. }

Full request

URL

  1. https://api.edmunds.com/api/inventory/v2/inventories?zipcode=90404&view=full&fmt=json

Response

  1. {
  2. "inventories": [
  3. {
  4. "id": "0F0483EBB9EDF30081DBF3F5698CFEB8",
  5. "type": "NEW",
  6. "vin": "1C3CCCAB8FN559978",
  7. "stockNumber": "350175",
  8. "mileage": 16,
  9. "make": {
  10. "name": "Chrysler",
  11. "niceName": "chrysler"
  12. },
  13. "model": {
  14. "name": "200",
  15. "niceName": "200"
  16. },
  17. "year": {
  18. "id": 200490591,
  19. "year": 2015
  20. },
  21. "style": {
  22. "id": 200674795,
  23. "name": "Limited 4dr Sedan (2.4L 4cyl 9A)",
  24. "submodel": {
  25. "body": "Sedan",
  26. "modelName": "200 Sedan",
  27. "niceName": "sedan"
  28. },
  29. "trim": "Limited",
  30. "link": {
  31. "rel": "_self",
  32. "href": "/api/vehicle/v2/styles/200674795"
  33. }
  34. },
  35. "media": {
  36. "photos": {
  37. "thumbnails": {
  38. "count": 2,
  39. "links": [
  40. {
  41. "rel": "_self",
  42. "href": "https://pictures.dealer.com/c/californiasuperstoresvalenciacllc/0209/c646513ccc02f8d1fb99db71bf9a363ex.jpg",
  43. "size": "LARGE"
  44. },
  45. {
  46. "rel": "_self",
  47. "href": "https://pictures.dealer.com/c/californiasuperstoresvalenciacllc/0209/c646513ccc02f8d1fb99db71bf9a363ex.jpg",
  48. "size": "MEDIUM"
  49. }
  50. ]
  51. }
  52. "other": {
  53. "count": 32,
  54. "links": [
  55. {
  56. "rel": "related",
  57. "href": "/api/media/v2/styles/200674795/photos"
  58. }
  59. ]
  60. }
  61. },
  62. "videos": {
  63. "count": 0,
  64. "links": [
  65. {
  66. "rel": "related",
  67. "href": "/api/media/v2/styles/200674795/videos"
  68. }
  69. ]
  70. }
  71. },
  72. "colors": [
  73. {
  74. "id": "200674986",
  75. "name": "Black",
  76. "availability": "USED",
  77. "manufactureOptionName": "Black",
  78. "manufactureOptionCode": "A5X2",
  79. "category": "Interior",
  80. "colorChips": {
  81. "primary": {
  82. "r": 206,
  83. "g": 200,
  84. "b": 184,
  85. "hex": "CEC8B8"
  86. }
  87. },
  88. "fabricTypes": [
  89. {
  90. "name": "FABRIC_TYPE_1",
  91. "value": "premium cloth"
  92. }
  93. ]
  94. },
  95. {
  96. "id": "200674971",
  97. "name": "Velvet Red Pearl Coat",
  98. "availability": "USED",
  99. "manufactureOptionName": "Velvet Red Pearl Coat",
  100. "manufactureOptionCode": "PRV",
  101. "category": "Exterior",
  102. "colorChips": {
  103. "primary": {
  104. "r": 79,
  105. "g": 15,
  106. "b": 29,
  107. "hex": "4F0F1D"
  108. }
  109. }
  110. }
  111. ],
  112. "mpg": {
  113. "highway": "36",
  114. "city": "23"
  115. },
  116. "prices": {
  117. "msrp": 25375,
  118. "tmv": 23814,
  119. "invoice": 1500
  120. },
  121. "programs": {
  122. "leasePromise": {
  123. "active": false
  124. },
  125. "pricePromise": {
  126. "active": false,
  127. "disclaimer": "Plus government fees and taxes, any finance charges applicable to a financed purchase, any electronic filing charge, and any emission testing charge. Dealer is under no obligation to include or offer any additional equipment, products or services."
  128. }
  129. },
  130. "equipment": [
  131. {
  132. "name": "I-4 cyl",
  133. "equipmentType": "ENGINE",
  134. "cylinder": 4,
  135. "fuelType": "regular unleaded",
  136. "type": "gas"
  137. },
  138. {
  139. "name": "9 speed automatic",
  140. "equipmentType": "TRANSMISSION",
  141. "transmissionType": "AUTOMATIC"
  142. },
  143. ...
  144. {
  145. "id": "200713488",
  146. "name": "California Emissions",
  147. "equipmentType": "OPTION",
  148. "availability": "All",
  149. "price": {
  150. "baseMSRP": 0,
  151. "baseInvoice": 0,
  152. "estimateTmv": false
  153. },
  154. "manufactureOptionName": "California Emissions",
  155. "manufactureOptionCode": "NAE",
  156. "category": "Additional Fees",
  157. "attributes": [
  158. ],
  159. "equipment": [
  160. ]
  161. }
  162. ],
  163. "features": [
  164. "Seat Material: Premium Cloth",
  165. "Tire Pressure Monitoring",
  166. "Remote Anti Theft Alarm System",
  167. "Side Airbags: Dual Front",
  168. "Keyless Ignition",
  169. "Child Seat Anchors",
  170. "Cruise Control",
  171. "Pre Wired For Phone",
  172. "Auxiliary Audio Input And Usb With External Media Control",
  173. "Usb Connection",
  174. "1st Row Seats: Bucket",
  175. "Cargo Tie Downs",
  176. "Stability Control",
  177. "Traction Control"
  178. ],
  179. "dealer": {
  180. "dealerId": "1046",
  181. "name": "California Superstores Valencia",
  182. "franchiseId": "649665",
  183. "address": {
  184. "street": "23820 Creekside Rd",
  185. "city": "Valencia",
  186. "stateCode": "CA",
  187. "stateName": "California",
  188. "county": "Los Angeles",
  189. "country": "USA",
  190. "latitude": 34.418535,
  191. "longitude": -118.552833,
  192. "zipcode": "91355"
  193. },
  194. "premier": false,
  195. "link": {
  196. "rel": "_self",
  197. "href": "/api/dealer/v2/franchises/649665"
  198. }
  199. }
  200. },
  201. ...
  202. {
  203. "id": "BCAB31729795ECEB6E982C88C74626C0",
  204. "type": "NEW",
  205. "vin": "1C3CCCAB9FN535057",
  206. "stockNumber": "350011",
  207. "mileage": 14,
  208. "make": {
  209. "name": "Chrysler",
  210. "niceName": "chrysler"
  211. },
  212. "model": {
  213. "name": "200",
  214. "niceName": "200"
  215. },
  216. "year": {
  217. "id": 200490591,
  218. "year": 2015
  219. },
  220. "style": {
  221. "id": 200674795,
  222. "name": "Limited 4dr Sedan (2.4L 4cyl 9A)",
  223. "submodel": {
  224. "body": "Sedan",
  225. "modelName": "200 Sedan",
  226. "niceName": "sedan"
  227. },
  228. "trim": "Limited",
  229. "link": {
  230. "rel": "_self",
  231. "href": "/api/vehicle/v2/styles/200674795"
  232. }
  233. },
  234. "media": {
  235. "photos": {
  236. "thumbnails": {
  237. "count": 2,
  238. "links": [
  239. {
  240. "rel": "_self",
  241. "href": "https://pictures.dealer.com/c/californiasuperstoresvalenciacllc/0257/6fa45b963920bced0a1b3bce3c14c39cx.jpg",
  242. "size": "LARGE"
  243. },
  244. {
  245. "rel": "_self",
  246. "href": "https://pictures.dealer.com/c/californiasuperstoresvalenciacllc/0257/6fa45b963920bced0a1b3bce3c14c39cx.jpg",
  247. "size": "MEDIUM"
  248. }
  249. ]
  250. },
  251. "other": {
  252. "count": 32,
  253. "links": [
  254. {
  255. "rel": "related",
  256. "href": "/api/media/v2/styles/200674795/photos"
  257. }
  258. ]
  259. }
  260. },
  261. "videos": {
  262. "count": 0,
  263. "links": [
  264. {
  265. "rel": "related",
  266. "href": "/api/media/v2/styles/200674795/videos"
  267. }
  268. ]
  269. }
  270. },
  271. "colors": [
  272. {
  273. "id": "200674986",
  274. "name": "Black",
  275. "availability": "USED",
  276. "manufactureOptionName": "Black",
  277. "manufactureOptionCode": "A5X2",
  278. "category": "Interior",
  279. "colorChips": {
  280. "primary": {
  281. "r": 206,
  282. "g": 200,
  283. "b": 184,
  284. "hex": "CEC8B8"
  285. }
  286. },
  287. "fabricTypes": [
  288. {
  289. "name": "FABRIC_TYPE_1",
  290. "value": "premium cloth"
  291. }
  292. ]
  293. },
  294. {
  295. "id": "200674971",
  296. "name": "Velvet Red Pearl Coat",
  297. "availability": "USED",
  298. "manufactureOptionName": "Velvet Red Pearl Coat",
  299. "manufactureOptionCode": "PRV",
  300. "category": "Exterior",
  301. "colorChips": {
  302. "primary": {
  303. "r": 79,
  304. "g": 15,
  305. "b": 29,
  306. "hex": "4F0F1D"
  307. }
  308. }
  309. }
  310. ],
  311. "mpg": {
  312. "highway": "36",
  313. "city": "23"
  314. },
  315. "prices": {
  316. "msrp": 25740,
  317. "tmv": 24155,
  318. "guaranteedPrice": 1500
  319. },
  320. "programs": {
  321. "leasePromise": {
  322. "active": false
  323. },
  324. "pricePromise": {
  325. "active": false,
  326. "disclaimer": "Plus government fees and taxes, any finance charges applicable to a financed purchase, any electronic filing charge, and any emission testing charge. Dealer is under no obligation to include or offer any additional equipment, products or services."
  327. }
  328. },
  329. "equipment": [
  330. {
  331. "name": "I-4 cyl",
  332. "equipmentType": "ENGINE",
  333. "cylinder": 4,
  334. "fuelType": "regular unleaded",
  335. "type": "gas"
  336. },
  337. {
  338. "name": "9 speed automatic",
  339. "equipmentType": "TRANSMISSION",
  340. "transmissionType": "AUTOMATIC"
  341. },
  342. ...
  343. {
  344. "id": "200713488",
  345. "name": "California Emissions",
  346. "equipmentType": "OPTION",
  347. "availability": "All",
  348. "price": {
  349. "baseMSRP": 0,
  350. "baseInvoice": 0,
  351. "estimateTmv": false
  352. },
  353. "manufactureOptionName": "California Emissions",
  354. "manufactureOptionCode": "NAE",
  355. "category": "Additional Fees",
  356. "attributes": [
  357. ],
  358. "equipment": [
  359. ]
  360. }
  361. ],
  362. "features": [
  363. "Seat Material: Premium Cloth",
  364. "Tire Pressure Monitoring",
  365. "Remote Anti Theft Alarm System",
  366. "Side Airbags: Dual Front",
  367. "Keyless Ignition",
  368. "Child Seat Anchors",
  369. "Cruise Control",
  370. "Pre Wired For Phone",
  371. "Auxiliary Audio Input And Usb With External Media Control",
  372. "Usb Connection",
  373. "1st Row Seats: Bucket",
  374. "Cargo Tie Downs",
  375. "Stability Control",
  376. "Traction Control"
  377. ],
  378. "dealer": {
  379. "dealerId": "1046",
  380. "name": "California Superstores Valencia",
  381. "address": {
  382. "street": "23820 Creekside Rd",
  383. "city": "Valencia",
  384. "stateCode": "CA",
  385. "stateName": "California",
  386. "county": "Los Angeles",
  387. "country": "USA",
  388. "latitude": 34.418535,
  389. "longitude": -118.552833,
  390. "zipcode": "91355"
  391. },
  392. "franchiseId": "649665",
  393. "premier": true
  394. }
  395. }
  396. ],
  397. "inventoriesCount": 132926,
  398. "links": [
  399. {
  400. "rel": "first",
  401. "href": "/api/inventory/v2/inventories?zipcode=90404&view=full&pagesize=10&pagenum=1&fmt=json"
  402. },
  403. {
  404. "rel": "next",
  405. "href": "/api/inventory/v2/inventories?zipcode=9040&view=full4&pagesize=10&pagenum=2&fmt=json"
  406. },
  407. {
  408. "rel": "last",
  409. "href": "/api/inventory/v2/inventories?zipcode=90404&view=full&pagesize=10&pagenum=132926&fmt=json"
  410. }
  411. ]
  412. }