API · v1 · SNAPSHOT DIFF
Snapshot diff
Diff two signed snapshots of a dataset and receive every changed field with its full 14-tuple provenance contract attached.
Status: this endpoint currently returns a clearly labelled stub (
_stub: true, every change _illustrative: true). The response shape is production-final; real signed snapshots arrive Q3 2026.Authentication
Send Authorization: Bearer <key>. The public demo key pk_dx_sample is rate-limited; live fnt_ keys are production callers. A missing or unknown key returns 401.
Request
POST /api/v1/snapshots/diff
Authorization: Bearer pk_dx_sample
Content-Type: application/json
{
"dataset": "nppes",
"from_snapshot": "2026-04-01T00:00:00Z",
"to_snapshot": "2026-05-01T00:00:00Z",
"fields": ["taxonomy", "addresses"]
}dataset— required dataset id (e.g.nppes).from_snapshot/to_snapshot— required ISO 8601 timestamps or snapshot ids.fields— optional field allow-list; defaults to["taxonomy", "addresses"].
Response
Each changes[] record carries before / after values, each wrapped in the 14-tuple provenance contract, plus a change_type of added, removed, or modified. A summary object totals the three. The machine-readable schema lives at /api/v1/snapshots/diff/_schema.json (in-repo).