Getting started
Testing & mock data
Keys come in two modes. dd_live_ keys hit real city records. dd_test_ keys ride the same auth, the same envelopes, and the same pagination — but every endpoint answers from a deterministic fixture city. Build and CI-test your whole client against a test key, then swap in the live key without touching code. Every commissioned key ships with its test twin, and GET /v1/me reports "mode": "test"so you can assert you're pointed at the right world.
The public playground key
These docs embed a shared test key so you can explore without signing up — it's what the consoles and guide snippets use. Fixture data only, limited per IP (200/day):
dd_test_d23d83e5ee04c87b1fee30680033c31aa0ef7985The fixture city
Stable IDs, never changing — pin your tests to them. Eight restaurants across every grade band, three properties, three contractors:
| CAMIS | Restaurant |
|---|---|
| 90000001 | THE GILDED SPOON — Manhattan · French · A/9 · clean |
| 90000002 | BROOKLYN BAGEL WORKS — Brooklyn · A/12 |
| 90000003 | DRAGON PALACE — Manhattan · B/18 |
| 90000004 | LA COCINA DE ABUELA — Queens · B/22 |
| 90000005 | MIDNIGHT DINER — Bronx · C/38 · the verminous one (rats, mice, roaches) |
| 90000006 | HARBOR HOUSE OYSTERS — Staten Island · C/42 · hearing defaults + fines due |
| 90000007 | CROWN FRIED CLUCK — Brooklyn · Z/51 · CLOSED by the Health Department |
| 90000008 | SILK ROAD KEBAB — Queens · P/28 · grade pending |
| BBL | Property |
|---|---|
| 1900010001 | Manhattan · LOW · clean, one ok deadline |
| 3900020002 | Brooklyn · HIGH · $66,500 due, 3 defaults, overdue facade filing |
| 4900030003 | Queens · MODERATE · boiler defects (action_needed) |
| Slug | Contractor |
|---|---|
| test-titan-construction | SEVERE · 42 tickets · live reopen windows (the savings play) |
| test-borough-builders | MODERATE · 9 tickets |
| test-clean-slate-contracting | LOW · clean docket |
Test traffic is metered separately and never counts toward your live key's usage. Try the whole flow in the reference consoles — every endpoint's mock response is exactly this data.