Taxes and fees

Growth and upView as Markdown

State sales tax, an average local tax, title and registration fees for the ZIP's state, plus the dealer's documentation fee as crawled with the listing.

GEThttps://api.motorsdynamic.com/api/v2/taxes/{vin}

Plan and price

Plan	Access	Price
Free	No	not included
Growth	Yes	$0.005 per call
Scale	Yes	$0.003 per call
Enterprise	Yes	contract

A call is billed when it answers 2xx. See pricing.

Parameters

Name	In	Type	Required	Description
`vin`	path	string	yes	17-character VIN (case-insensitive).
`zip`	query	string	yes	5-digit ZIP code of a US state or DC.
`price`	query	number	no	Price to compute on. Default: the dealer's advertised price.
`tradeIn`	query	number	no	Trade-in value.
`rebate`	query	number	no	Manufacturer rebate applied to the price.
`docFee`	query	number	no	Dealer documentation fee. Default: the fee crawled with the car's listing.

Example request

curl "https://api.motorsdynamic.com/api/v2/taxes/1HGCM82633A004352?zip=value" \
  -H "x-api-key: $MD_API_KEY"

const res = await fetch("https://api.motorsdynamic.com/api/v2/taxes/1HGCM82633A004352?zip=value", {
  headers: { "x-api-key": process.env.MD_API_KEY },
});
if (!res.ok) throw new Error(`${res.status} ${(await res.json()).error}`);
const data = await res.json();
console.log(data);

import os, requests

res = requests.get(
    "https://api.motorsdynamic.com/api/v2/taxes/1HGCM82633A004352?zip=value",
    headers={"x-api-key": os.environ["MD_API_KEY"]},
    timeout=10,
)
res.raise_for_status()
print(res.json())

Response fields

Field	Type	Description
`meta`	object
`data`	object

Errors

Status	Code	When
400	`invalid_parameter`	A parameter is missing or malformed. The message names it.
401	`invalid_api_key`	The key is missing, revoked or mistyped.
402	`plan_required`	The endpoint is on a higher plan. The body names the plan and links to the upgrade.
403	`not_entitled`	The key may not read this dealer or source.
404	`not_found`	Nothing matches the identifier in the path.
429	`rate_limited or quota_exceeded`	Slow down (see `Retry-After`), or the Free monthly calls are used up.
503	`error`	See the message.
504	`query_timeout`	The query passed its 4 second budget. Narrow the filters. Not billed.

Every error has the same body. Full list: errors.