DEAL HISTORY API
Retrieve a property’s observed deal-marketing history.
Use GET /api/v1/properties/{property_id}/events for a bounded, newest-first sequence of marketing events tied to a known AZ Deal Map property ID.
01
Request contract
Provide the opaque property_id in the path. Both from and to are required RFC 3339 timestamps; they must be ordered and span no more than 366 days. Pages default to 25 events and allow 1–100.
Send a Bearer API key and unique Idempotency-Key. Results are ordered by event_at descending, then event ID. Follow meta.next_cursor unchanged when more results exist.
curl 'https://azdealmap.com/api/v1/properties/prop_example_28bc04/events?from=2026-01-01T00%3A00%3A00Z&to=2026-06-30T23%3A59%3A59Z&limit=25' \
-H 'Authorization: Bearer YOUR_SERVER_SIDE_API_KEY' \
-H 'Idempotency-Key: history-example-001'02
Representative response
Synthetic, sanitized example only. It does not reproduce a proprietary marketing record.
{
"data": [{
"event_id": "event_example_91ca20",
"property_id": "prop_example_28bc04",
"zip": "85000",
"event_at": "2026-04-12T18:15:00.000Z",
"ask_cents": 23900000,
"status": "Active",
"source_category": "wholesale_marketing",
"synced_at": "2026-04-12T18:30:00.000Z"
}],
"meta": {
"request_id": "00000000-0000-4000-8000-000000000000",
"as_of": "2026-06-30T23:59:59.000Z",
"next_cursor": null,
"has_more": false,
"credits_charged": 2,
"credits_remaining": 498
}
}Each event can include its opaque event and property IDs, ZIP, event time, asking price in integer USD cents, observed marketing status, an approved coarse source category, and sync time. Unknown values may be null.
03
Credits and limits
Each newly billed marketing event costs 2 credits. Eligible repeat retrieval of the same event representation by the same account within 24 hours costs zero additional credits. Empty results and errors cost zero.
The service refuses to serve marketing-event history when the latest successful events sync is more than 168 hours old. Sandbox keys are limited to sanitized live-deal fixtures, so this history endpoint requires paid access and the appropriate key scope.
04
How to interpret history
A sequence can show that AZ Deal Map observed a property marketed at particular times, asking prices, and statuses. Repeated events may help identify price movement or recirculation.