ACTIVE DEALS API
Query active Arizona off-market deal observations.
Use GET /api/v1/live-deals to retrieve the latest active marketed-offer records AZ Deal Map can serve. Filter the feed, follow opaque cursors, and use the returned timestamps to judge recency.
01
Request contract
Send a Bearer API key and a unique Idempotency-Key header. Supported filters are zip, city, status, min_price, max_price, and RFC 3339 updated_since. Price filters are integer USD cents.
Pages default to 25 records and allow 1–100. Pass meta.next_cursor unchanged as cursor while meta.has_more is true.
curl 'https://azdealmap.com/api/v1/live-deals?zip=85004&status=Active&limit=2' \
-H 'Authorization: Bearer YOUR_SERVER_SIDE_API_KEY' \
-H 'Idempotency-Key: active-85004-001'02
Representative response
Synthetic, sanitized example only. It is not a proprietary or currently available deal.
{
"data": [{
"deal_id": "deal_example_7f3a91",
"property_id": "prop_example_28bc04",
"street_address": "123 Example Desert Rd",
"city": "Sample City",
"state": "AZ",
"zip": "85000",
"latitude": null,
"longitude": null,
"status": "Active",
"ask_cents": 24500000,
"observed_at": "2026-08-01T15:30:00.000Z",
"source_updated_at": null,
"synced_at": "2026-08-01T15:31:00.000Z"
}],
"meta": {
"request_id": "00000000-0000-4000-8000-000000000000",
"as_of": "2026-08-01T15:31:00.000Z",
"next_cursor": null,
"has_more": false,
"credits_charged": 1,
"credits_remaining": 24
}
}Returned rows include opaque deal and conservatively matched property IDs, location fields, coordinates when known, marketing status, ask_cents, observation/source-update times, and sync time. A null value means unknown or unavailable; it is not filled by guesswork.
03
Credits and freshness
Each returned deal costs 1 credit. The same account is not charged again for the same deal representation retrieved within 24 hours. Empty results and errors cost zero.
The live-deal service refuses to serve when its latest successful dataset sync is more than 48 hours old. meta.as_of is the response time; use row-level observed_at, source_updated_at, and synced_at to interpret the record itself.
04
What “active” and “off-market” mean
These are marketing observations that satisfied AZ Deal Map’s active serving rule at the latest successful observation. They can support monitoring and workflow triage.