Inventory change feed

Listing events (listed, price and status changes, ...) written by the v2 crawler, in commit-safe order (by writing transaction, then event id). Poll with the returned next_cursor; it is returned even when the page is empty. An event becomes visible once every transaction older than its own has finished (meta.watermark), which guarantees that a cursor never skips an event committed later. Sites still written by the legacy pipeline (meta.emits_events: false) have an empty feed until they are promoted.

Plan and price

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

Parameters

Example request

curl "https://api.motorsdynamic.com/api/v2/dealers/101/changes?since=2026-09-20T00%3A00%3A00Z&types=price_changed" \
  -H "x-api-key: $MD_API_KEY"

const res = await fetch("https://api.motorsdynamic.com/api/v2/dealers/101/changes?since=2026-09-20T00%3A00%3A00Z&types=price_changed", {
  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/dealers/101/changes?since=2026-09-20T00%3A00%3A00Z&types=price_changed",
    headers={"x-api-key": os.environ["MD_API_KEY"]},
    timeout=10,
)
res.raise_for_status()
print(res.json())

Example response

{
  "data": [
    {
      "event_id": "00000000-0000-4000-8000-000000000002",
      "domain_id": 101,
      "vin": "1FTFW1E50NFA00001",
      "source_key": "1FTFW1E50NFA00001",
      "event_type": "price_changed",
      "observed_at": "2026-09-21T00:00:00.000000Z",
      "prev": {
        "price": 41000
      },
      "next": {
        "price": 40000
      },
      "entity_version": 3,
      "episode": 1,
      "freshness": {
        "observed_at": "2026-09-21T00:00:00.000000Z"
      },
      "provenance": {
        "source": "v2",
        "adapter_version": "dealer-inspire@3",
        "run_id": 77,
        "quality": null
      }
    }
  ],
  "page": {
    "limit": 500,
    "has_more": false,
    "next_cursor": "eyJ2IjoxfQ"
  },
  "meta": {
    "domain_id": 101,
    "since": "2026-09-20T00:00:00.000Z",
    "writer": "v2",
    "emits_events": true,
    "watermark": "771234"
  }
}

Response fields

Errors

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