Get an Event
Retrieve a specific property deed event by its unique identifier
Use the GET /v1/events/{event_id} endpoint to retrieve a single event by its ID. Webhook deliveries include a link to this endpoint so you can fetch the full event details after receiving a notification.
Invite-Only Access
The Events API is currently available by invite only. To request access, contact our support team at support@whitepages.com or visit the Support and Incident Response page.
Basic Usage
Retrieve an event by its ID:
curl 'https://api.whitepages.com/v1/events/evt_abc123' \
--header 'X-Api-Key: YOUR_API_KEY'Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
event_id | string | Yes | The unique identifier of the event (e.g., evt_abc123) |
Response
The response returns the full event object wrapped in a result envelope:
{
"result": {
"id": "evt_abc123",
"object": "event",
"event_type": "deed.transfer",
"data": {
"jurisdiction": {
"county": "King",
"state": "WA",
"fips_code": "53033"
},
"property": {
"property_id": "prop_123",
"property_address": {
"line1": "123 Main St",
"city": "Seattle",
"state": "WA",
"zip": "98101",
"county": "King"
},
"apn": "123456-7890",
"parcel_id": "P-7890",
"geolocation": {
"lat": 47.6062,
"lng": -122.3321
},
"legal_description": null,
"bedrooms": 3,
"bathrooms": 2.5,
"living_sqft": 1850,
"lot_sqft": 5000,
"property_purpose": "single_family"
},
"parties": [
{
"role": "grantor",
"name": "Jane Doe",
"type": "individual",
"person_id": "per_456",
"addresses": [{ "full_address": "123 Main St, Seattle, WA 98101" }]
},
{
"role": "grantee",
"name": "John Smith",
"type": "individual",
"person_id": null,
"addresses": []
}
],
"detail": {
"document_type": {
"category": "deed",
"text": "Warranty Deed"
},
"recorded_date": "2026-02-27",
"instrument_date": "2026-02-25",
"consideration": 750000,
"transaction_reason": {
"category": "sale",
"text": "Arms-length sale"
}
}
}
}
}Webhook Integration
Webhook notifications include a links array with the URL to this endpoint.
After receiving a notification, call the linked URL to retrieve the full event
details.
For full request and response schemas, see the Retrieve a single event by ID API reference.