Events
Retrieve a single event by ID
Return a single event by its unique identifier.
Authorization
ApiKeyAuth x-api-key<token>
API key for authentication. Get your key from the Whitepages developer portal.
In: header
Path Parameters
event_id*Event ID
Unique event identifier
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/events/string"{
"result": {
"id": "string",
"object": "event",
"event_type": "string",
"data": {
"jurisdiction": {
"county": "string",
"state": "string",
"fips_code": "string"
},
"property": {
"property_id": "string",
"property_address": {
"line1": "string",
"city": "string",
"state": "string",
"zip": "string",
"county": "string"
},
"apn": "string",
"parcel_id": "string",
"geolocation": {
"lat": 0,
"lng": 0
},
"legal_description": {
"text": "string"
},
"bedrooms": 0,
"bathrooms": 0,
"living_sqft": 0,
"lot_sqft": 0,
"property_purpose": "string"
},
"parties": [
{
"role": "string",
"name": "string",
"type": "string",
"person_id": "string",
"addresses": [
{
"full_address": "string"
}
]
}
],
"detail": {
"document_type": {
"category": "string",
"text": "string"
},
"recorded_date": "string",
"instrument_date": "string",
"consideration": 0,
"transaction_reason": {
"category": "string",
"text": "string"
}
}
}
}
}{
"error": {
"code": 400,
"message": "Bad Request",
"long_message": "Invalid person ID format: 'sdf'. Person ID must start with 'P' followed by exactly 10 alphanumeric characters. Example: 'PABcd12345e' or 'P1234567890'.",
"meta": null
},
"wp_trace_id": "3b0b537a60d84057817bb40563ca5c99"
}{
"message": "Forbidden"
}{
"error": {
"code": 404,
"message": "Not Found",
"long_message": "Person id not found: PABcd12345e",
"meta": null
},
"wp_trace_id": "0c57473114bd49b3b3c4b585df624f2f"
}{
"error": {
"code": 422,
"message": "Unprocessable Entity",
"long_message": "The request contains semantic errors and cannot be processed",
"meta": null
},
"wp_trace_id": "7e5f2c9a1d8b4e6f9c0a3b5d7e1f2a4c"
}{
"error": {
"code": 500,
"message": "Internal Server Error",
"long_message": "An internal server error occurred",
"meta": null
},
"wp_trace_id": "9c1a4e7f2b8d4c6a9e0f3b5d7c1a2e4f"
}Related
Search all deed events GET
Search historical deed events by region and optional filters. A request whose `event_date_from` falls after its `event_date_to` is rejected.
Create a webhook subscription POST
Register a new webhook subscription for property events. The endpoint URL is validated on creation — it must be reachable and return a 2xx response. Currently supports `deed.*` events scoped to Texas counties.