Api documentation

Api documentation

Get Vehicle Incentives and Rebates by Vehicle Category and Zipcode

Price: Incentives and Rebates


Get incentives and rebates that apply to a specific car category (see static datasets in the Vehicle API overview for a list of available car or vehicle categories) and zip code.


https://api.edmunds.com/v1/api/incentive/incentiverepository/findincentivesbycategoryandzipcode?category={car category}&zipcode={zip code}&fmt=json&api_key={api key}

Code Example

You need the Javascript SDK to run this example.

<!DOCTYPE html>

	<meta charset=utf-8>
	<title>Edmunds API Example</title>

	<div id="results-body"></div>
	  	window.sdkAsyncInit = function() {
	    	// Instantiate the SDK
			var res = new EDMUNDSAPI('YOUR API KEY');

			// Optional parameters
			var options = {
				"category": "Sedan",
				"zipcode": "90019"

			// Callback function to be called when the API response is returned
			function success(res) {
				var body = document.getElementById('results-body');
				body.innerHTML = "The incentive name is: " + res.incentiveHolder[0].name;

			// Oops, Houston we have a problem!
			function fail(data) {

			// Fire the API call
			res.api('/v1/api/incentive/incentiverepository/findincentivesbycategoryandzipcode', options, success, fail);

		    // Additional initialization code such as adding Event Listeners goes here

	  // Load the SDK asynchronously
	  (function(d, s, id){
	     	var js, sdkjs = d.getElementsByTagName(s)[0];
	     	if (d.getElementById(id)) {return;}
	     	js = d.createElement(s); js.id = id;
	     	js.src = "path/to/sdk/file";
	     	sdkjs.parentNode.insertBefore(js, sdkjs);
	   }(document, 'script', 'edmunds-jssdk'));