Special history

GEThttps://api.motorsdynamic.com/api/v2/specials/{specialId}/history

Plan and price

Plan	Access	Price
Free	No	not included
Growth	No	not included
Scale	No	not included
Enterprise	Yes	contract

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

Parameters

Name	In	Type	Required	Description
`specialId`	path	integer	yes
`source`	query	`published` or `shadow`	no

Example request

curl "https://api.motorsdynamic.com/api/v2/specials/9001/history" \
  -H "x-api-key: $MD_API_KEY"

const res = await fetch("https://api.motorsdynamic.com/api/v2/specials/9001/history", {
  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/specials/9001/history",
    headers={"x-api-key": os.environ["MD_API_KEY"]},
    timeout=10,
)
res.raise_for_status()
print(res.json())

Example response

{
  "data": [
    {
      "history_id": 501,
      "special_id": 9001,
      "domain_id": 201,
      "change_type": "changed",
      "changed_cols": [
        "monthly_payment",
        "offer_amount"
      ],
      "prev": {
        "monthly_payment": 519
      },
      "next": {
        "monthly_payment": 499
      },
      "observed_at": "2026-09-24T10:00:00.000000Z",
      "provenance": {
        "source": "v2_specials",
        "mode": "publish",
        "run_id": 77
      }
    }
  ],
  "meta": {
    "special_id": 9001,
    "source": "published"
  }
}

Response fields

Field	Type	Description
`data[]`	array of object
`data[].history_id`	integer
`data[].special_id`	integer
`data[].domain_id`	integer
`data[].change_type`	`listed` or `changed` or `relisted` or `removed` or `adopted`
`data[].changed_cols[]`	array of string
`data[].prev`	object or null
`data[].next`	object or null
`data[].observed_at`	string or null	RFC 3339 UTC with microseconds.
`data[].provenance`	object
`data[].provenance.source`	`v2_specials`
`data[].provenance.mode`	`shadow` or `publish`
`data[].provenance.run_id`	integer or null
`meta`	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.
504	`query_timeout`	The query passed its 4 second budget. Narrow the filters. Not billed.

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