Get a free key
Quickstart

Quickstart

View as Markdown

From no account to a live response in about a minute.

1. Get a key

Sign in with your email. We send a 6-digit code, and your first key is created the moment you enter it. The Free plan gives you 1,000 calls a month and needs no card.

Keys start with md_dev_. Keep one in an environment variable:

export MD_API_KEY="md_dev_..."

2. Make a call

VIN decode:

curl "https://api.motorsdynamic.com/api/v2/vin/1HGCM82633A004352" \
  -H "x-api-key: $MD_API_KEY"

The same call in JavaScript:

const res = await fetch("https://api.motorsdynamic.com/api/v2/vin/1HGCM82633A004352", {
  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);

And in Python:

import os, requests

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

3. Read the headers

Every response tells you where you stand:

Header Meaning
X-MD-Plan The plan the key is on.
X-MD-Units Billing units this endpoint costs per successful call.
X-MD-Calls-Used, X-MD-Calls-Remaining Free plan: calls used and left this month.
X-RateLimit-Remaining, X-RateLimit-Reset Requests left in the current minute, and seconds until it resets.

4. Go further