- Previous: Model Year Repository
- Up: The Vehicle API V1
- Next: Model Repository
Make Repository
The Make repository provides information according to the Make of a vehicle.
Go to:
URL
http://api.edmunds.com/{version}/api/vehicle/makerepository/{method}Response Formattop
All method responsed are JSON obects with a root property called, makeHolder. The value of makeHolder is an array of Make objects:
{
"makeHolder": [
make_object_1,
make_object_2,
make_object_3,
....
....
]
}Each make object is a JSON object of the following format:
{
"id": [integer],
"models": [
model_object_1,
model_object_2,
...
],
"name": [string],
"niceName": [string],
"attributeGroups": [object]
}The properties of the Make object are:
- id: The make ID
- models: array of model objects (see below)
- name: the make name
- niceName: The make nice name, or URL-friendly name
- attributeGroups: [description]
The model object has the following structure:
{
"link": "/api/vehicle/acura/slx",
"id": "Acura_SLX",
"name": "SLX"
}The properties in the model object are:
- link: API call to get more details about this model
- id: The model ID
- name: The model name
Sample Requesttop
http://api.edmunds.com/{version}/api/vehicle/makerepository/findall?api_key=xxxxxxxxxx&fmt=jsonSample Response
{
"makeHolder": [
{
"id": 200347864,
"models": [
{
"link": "/api/vehicle/am-general/hummer",
"id": "AM_General_Hummer",
"name": "Hummer"
}
],
"name": "AM General",
"niceName": "amgeneral",
"attributeGroups": {}
},
{
"id": 200002038,
"models": [
{
"link": "/api/vehicle/acura/slx",
"id": "Acura_SLX",
"name": "SLX"
},
{
"link": "/api/vehicle/acura/legend",
"id": "Acura_Legend",
"name": "Legend"
},
{
"link": "/api/vehicle/acura/rsx",
"id": "Acura_RSX",
"name": "RSX"
},
{
"link": "/api/vehicle/acura/tsxsportwagon",
"id": "Acura_TSX_Sport_Wagon",
"name": "TSX Sport Wagon"
},
{
"link": "/api/vehicle/acura/rl",
"id": "Acura_RL",
"name": "RL"
},
{
"link": "/api/vehicle/acura/tl",
"id": "Acura_TL",
"name": "TL"
},
{
"link": "/api/vehicle/acura/tsx",
"id": "Acura_TSX",
"name": "TSX"
},
{
"link": "/api/vehicle/acura/vigor",
"id": "Acura_Vigor",
"name": "Vigor"
},
{
"link": "/api/vehicle/acura/integra",
"id": "Acura_Integra",
"name": "Integra"
},
{
"link": "/api/vehicle/acura/cl",
"id": "Acura_CL",
"name": "CL"
},
{
"link": "/api/vehicle/acura/zdx",
"id": "Acura_ZDX",
"name": "ZDX"
},
{
"link": "/api/vehicle/acura/nsx",
"id": "Acura_NSX",
"name": "NSX"
},
{
"link": "/api/vehicle/acura/rdx",
"id": "Acura_RDX",
"name": "RDX"
},
{
"link": "/api/vehicle/acura/mdx",
"id": "Acura_MDX",
"name": "MDX"
}
],
"name": "Acura",
"niceName": "acura",
"attributeGroups": {}
},
{
"id": 200001769,
"models": [
{
"link": "/api/vehicle/aston-martin/v12vanquish",
"id": "Aston_Martin_V12_Vanquish",
"name": "V12 Vanquish"
},
{
"link": "/api/vehicle/aston-martin/db7",
"id": "Aston_Martin_DB7",
"name": "DB7"
},
{
"link": "/api/vehicle/aston-martin/v8vantage",
"id": "Aston_Martin_V8_Vantage",
"name": "V8 Vantage"
},
{
"link": "/api/vehicle/aston-martin/v12vantage",
"id": "Aston_Martin_V12_Vantage",
"name": "V12 Vantage"
},
{
"link": "/api/vehicle/aston-martin/virage",
"id": "Aston_Martin_Virage",
"name": "Virage"
},
{
"link": "/api/vehicle/aston-martin/db9",
"id": "Aston_Martin_DB9",
"name": "DB9"
},
{
"link": "/api/vehicle/aston-martin/rapide",
"id": "Aston_Martin_Rapide",
"name": "Rapide"
},
{
"link": "/api/vehicle/aston-martin/dbs",
"id": "Aston_Martin_DBS",
"name": "DBS"
}
],
"name": "Aston Martin",
"niceName": "astonmartin",
"attributeGroups": {}
},
...
...
...
{
"id": 200000238,
"models": [
{
"link": "/api/vehicle/volkswagen/golf",
"id": "Volkswagen_Golf",
"name": "Golf"
},
{
"link": "/api/vehicle/volkswagen/eos",
"id": "Volkswagen_Eos",
"name": "Eos"
},
{
"link": "/api/vehicle/volkswagen/vanagon",
"id": "Volkswagen_Vanagon",
"name": "Vanagon"
},
{
"link": "/api/vehicle/volkswagen/fox",
"id": "Volkswagen_Fox",
"name": "Fox"
},
{
"link": "/api/vehicle/volkswagen/newbeetle",
"id": "Volkswagen_New_Beetle",
"name": "New Beetle"
},
{
"link": "/api/vehicle/volkswagen/polo",
"id": "Volkswagen_Polo",
"name": "Polo"
},
{
"link": "/api/vehicle/volkswagen/routan",
"id": "Volkswagen_Routan",
"name": "Routan"
},
{
"link": "/api/vehicle/volkswagen/corrado",
"id": "Volkswagen_Corrado",
"name": "Corrado"
},
{
"link": "/api/vehicle/volkswagen/golfr",
"id": "Volkswagen_Golf_R",
"name": "Golf R"
},
{
"link": "/api/vehicle/volkswagen/eurovan",
"id": "Volkswagen_EuroVan",
"name": "EuroVan"
},
{
"link": "/api/vehicle/volkswagen/jetta",
"id": "Volkswagen_Jetta",
"name": "Jetta"
},
{
"link": "/api/vehicle/volkswagen/cabriolet",
"id": "Volkswagen_Cabriolet",
"name": "Cabriolet"
},
{
"link": "/api/vehicle/volkswagen/gli",
"id": "Volkswagen_GLI",
"name": "GLI"
},
{
"link": "/api/vehicle/volkswagen/rabbit",
"id": "Volkswagen_Rabbit",
"name": "Rabbit"
},
{
"link": "/api/vehicle/volkswagen/touareg",
"id": "Volkswagen_Touareg",
"name": "Touareg"
},
{
"link": "/api/vehicle/volkswagen/r32",
"id": "Volkswagen_R32",
"name": "R32"
},
{
"link": "/api/vehicle/volkswagen/jettasportwagen",
"id": "Volkswagen_Jetta_SportWagen",
"name": "Jetta SportWagen"
},
{
"link": "/api/vehicle/volkswagen/beetle",
"id": "Volkswagen_Beetle",
"name": "Beetle"
},
{
"link": "/api/vehicle/volkswagen/cabrio",
"id": "Volkswagen_Cabrio",
"name": "Cabrio"
},
{
"link": "/api/vehicle/volkswagen/passat",
"id": "Volkswagen_Passat",
"name": "Passat"
},
{
"link": "/api/vehicle/volkswagen/phaeton",
"id": "Volkswagen_Phaeton",
"name": "Phaeton"
},
{
"link": "/api/vehicle/volkswagen/up",
"id": "Volkswagen_Up!",
"name": "Up!"
},
{
"link": "/api/vehicle/volkswagen/cc",
"id": "Volkswagen_CC",
"name": "CC"
},
{
"link": "/api/vehicle/volkswagen/gti",
"id": "Volkswagen_GTI",
"name": "GTI"
},
{
"link": "/api/vehicle/volkswagen/touareg2",
"id": "Volkswagen_Touareg_2",
"name": "Touareg 2"
},
{
"link": "/api/vehicle/volkswagen/tiguan",
"id": "Volkswagen_Tiguan",
"name": "Tiguan"
},
{
"link": "/api/vehicle/volkswagen/touareghybrid",
"id": "Volkswagen_Touareg_Hybrid",
"name": "Touareg Hybrid"
}
],
"name": "Volkswagen",
"niceName": "volkswagen",
"attributeGroups": {}
},
{
"id": 200010382,
"models": [
{
"link": "/api/vehicle/volvo/coupe",
"id": "Volvo_Coupe",
"name": "Coupe"
},
{
"link": "/api/vehicle/volvo/960",
"id": "Volvo_960",
"name": "960"
},
{
"link": "/api/vehicle/volvo/c30",
"id": "Volvo_C30",
"name": "C30"
},
{
"link": "/api/vehicle/volvo/s70",
"id": "Volvo_S70",
"name": "S70"
},
{
"link": "/api/vehicle/volvo/s80",
"id": "Volvo_S80",
"name": "S80"
},
{
"link": "/api/vehicle/volvo/940",
"id": "Volvo_940",
"name": "940"
},
{
"link": "/api/vehicle/volvo/s90",
"id": "Volvo_S90",
"name": "S90"
},
{
"link": "/api/vehicle/volvo/850",
"id": "Volvo_850",
"name": "850"
},
{
"link": "/api/vehicle/volvo/s60",
"id": "Volvo_S60",
"name": "S60"
},
{
"link": "/api/vehicle/volvo/240",
"id": "Volvo_240",
"name": "240"
},
{
"link": "/api/vehicle/volvo/v40",
"id": "Volvo_V40",
"name": "V40"
},
{
"link": "/api/vehicle/volvo/xc60",
"id": "Volvo_XC60",
"name": "XC60"
},
{
"link": "/api/vehicle/volvo/740",
"id": "Volvo_740",
"name": "740"
},
{
"link": "/api/vehicle/volvo/s40",
"id": "Volvo_S40",
"name": "S40"
},
{
"link": "/api/vehicle/volvo/760",
"id": "Volvo_760",
"name": "760"
},
{
"link": "/api/vehicle/volvo/780",
"id": "Volvo_780",
"name": "780"
},
{
"link": "/api/vehicle/volvo/v50",
"id": "Volvo_V50",
"name": "V50"
},
{
"link": "/api/vehicle/volvo/v70",
"id": "Volvo_V70",
"name": "V70"
},
{
"link": "/api/vehicle/volvo/v90",
"id": "Volvo_V90",
"name": "V90"
},
{
"link": "/api/vehicle/volvo/xc90",
"id": "Volvo_XC90",
"name": "XC90"
},
{
"link": "/api/vehicle/volvo/xc70",
"id": "Volvo_XC70",
"name": "XC70"
},
{
"link": "/api/vehicle/volvo/c70",
"id": "Volvo_C70",
"name": "C70"
},
{
"link": "/api/vehicle/volvo/xc",
"id": "Volvo_XC",
"name": "XC"
}
],
"name": "Volvo",
"niceName": "volvo",
"attributeGroups": {}
},
{
"id": 200038885,
"models": [
{
"link": "/api/vehicle/smart/fortwo",
"id": "smart_fortwo",
"name": "fortwo"
}
],
"name": "smart",
"niceName": "smart",
"attributeGroups": {}
}
]
}
Available Methodstop
| Method | Description |
|---|---|
findall |
Get the list of all makes and their all their models |
| Find a make and its models by providing a make ID | |
findfuturemakes |
Find all future makes and their models |
findmakebyname |
Find a make details by its name |
findmakesbymodelyear |
Find a make by a year |
findmakesbypublicationstate |
Find makes by their state (new or used) |
findnewandused |
Find all new and used makes |
findnewandusedmakesbymodelyear |
Find all new and used makes for a particular year |
findnewmakes |
Find only new makes |
findusedmakes |
Find only old makes |
Method: findall
URL
http://api.edmunds.com/{version}/api/vehicle/makerepository/findall?api_key=xxxxxxxxxx&fmt=jsonParameters
None.
Method: findbyid
URL
http://api.edmunds.com/{version}/api/vehicle/makerepository/findbyid?id=xxx&api_key=xxxxxxxxxx&fmt=jsonParameters
| Name and Description | Required? |
|
Vehicle make ID |
Yes |
Method: findfuturemakes
URL
http://api.edmunds.com/{version}/api/vehicle/makerepository/findfuturemakes?api_key=xxxxxxxxxx&fmt=jsonParameters
None.
Method: findmakebyname
URL
http://api.edmunds.com/{version}/api/vehicle/makerepository/findmakebyname?name=xxx&api_key=xxxxxxxxxx&fmt=jsonParameters
| Name and Description | Required? |
|
The name of the make. Use the niceName value of the make. |
Yes |
Method: findmakesbymodelyear
URL
http://api.edmunds.com/{version}/api/vehicle/makerepository/findmakesbymodelyear?year=xxxx&api_key=xxxxxxxxxx&fmt=jsonParameters
| Name and Description | Required? |
|
The four-digit year of interest |
Yes |
Method: findmakesbypublicationstate
URL
http://api.edmunds.com/{version}/api/vehicle/makerepository/findmakesbypublicationstate?state=xx&api_key=xxxxxxxxxx&fmt=jsonParameters
| Name and Description | Required? |
|
One of these three values: new|used|future |
Yes |
Method: findnewandused
URL
http://api.edmunds.com/{version}/api/vehicle/makerepository/findnewandused?api_key=xxxxxxxxxx&fmt=jsonParameters
None.
Method: findnewandusedmakesbymodelyear
URL
http://api.edmunds.com/{version}/api/vehicle/makerepository/findnewandusedmakesbymodelyear?year=xxxx&api_key=xxxxxxxxxx&fmt=jsonParameters
| Name and Description | Required? |
|
The four-digit year of interest |
Yes |
Method: findnewmakes
URL
http://api.edmunds.com/{version}/api/vehicle/makerepository/findnewmakes?api_key=xxxxxxxxxx&fmt=jsonParameters
None.
Method: findusedmakes
URL
http://api.edmunds.com/{version}/api/vehicle/makerepository/findusedmakes?api_key=xxxxxxxxxx&fmt=jsonParameters
None.
- Previous: Model Year Repository
- Up: The Vehicle API V1
- Next: Model Repository
1 Comment
James Manning – 11 months ago
The attributeGroups property in the response seems to be empty and the description on this page just says "[description]" - is it always empty? If not, what would be in it?
Thanks!
Please sign in to post a comment.