---
title: "Search all deed events"
method: GET
path: "/v1/events/deed"
tags: ["Events"]
---

# Search all deed events

`GET /v1/events/deed`

Search historical deed events by region and optional filters.

Raises
------
EventInvalidParameterError
    When event_date_from is after event_date_to.

## Query parameters

- `region` string, required — Geographic scope in type:value format (e.g., state:tx, county:tx.travis, county:48453)
- `property_id` string, nullable — Whitepages property ID filter
- `event_date_from` string, date, nullable — Start of event date range, inclusive (ISO 8601)
- `event_date_to` string, date, nullable — End of event date range, inclusive (ISO 8601)
- `limit` integer — Results per page
- `cursor` string, nullable — Pagination cursor from a previous response

## Response `200`

Deed events retrieved successfully

- SearchDeedEventsResponseDto — Response for deed event search endpoints.
  - `results` EventResponseDto[] — Matching events
    - `id` string, required — Unique event identifier (UUID)
    - `object` string — Object type
    - `event_type` string, required — Event type
    - `data` DeedEventDataDto, required — Data payload for deed events.
      - `jurisdiction` JurisdictionDto, required — Geographic jurisdiction.
        - `county` string, nullable — County name
        - `state` string, required — State code
        - `fips_code` string, nullable — FIPS county code
      - `property` PropertyDto — Property involved in the event.
        - `property_id` string, nullable — Whitepages property ID
        - `property_address` EventPropertyAddressDto — Structured property address.
          - `line1` string, nullable — Street address
          - `city` string, nullable — City
          - `state` string, nullable — State code
          - `zip` string, nullable — ZIP code
          - `county` string, nullable — County name
        - `apn` string, nullable — Assessor Parcel Number
        - `parcel_id` string, nullable — Parcel identifier
        - `geolocation` EventGeolocationDto — Geocoordinates.
          - `lat` number, required — Latitude
          - `lng` number, required — Longitude
        - `legal_description` LegalDescriptionDto — Legal description of a property.
          - `text` string, nullable — Full legal description as raw text
        - `bedrooms` integer, nullable — Number of bedrooms
        - `bathrooms` number, nullable — Number of bathrooms
        - `living_sqft` integer, nullable — Living area in square feet
        - `lot_sqft` integer, nullable — Lot size in square feet
        - `property_purpose` string, nullable — Property type
      - `parties` PartyDto[] — Parties involved
        - `role` string, required — Party role
        - `name` string, nullable — Full name of person or entity
        - `type` string, nullable — Entity type
        - `person_id` string, nullable — Whitepages person ID if resolved
        - `addresses` PartyAddressDto[] — Associated addresses
          - `full_address` string, required — Formatted full address
      - `detail` DeedDetailDto — Deed-specific event detail.
        - `document_type` DocumentTypeDto — Document classification.
          - `category` string, nullable — Normalized category
          - `text` string, nullable — Human-readable label
        - `recorded_date` string, nullable — Date the deed was recorded (ISO 8601)
        - `instrument_date` string, nullable — Date the deed was executed (ISO 8601)
        - `consideration` number, nullable — Sale price or consideration amount
        - `transaction_reason` TransactionReasonDto — Transaction classification.
          - `category` string, nullable — Normalized category
          - `text` string, nullable — Human-readable label
  - `pagination` PaginationDto, required — Cursor-based pagination metadata.
    - `next_cursor` string, nullable — Cursor for the next page of results

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `422` — Unprocessable Content
- `500` — Internal Server Error

---

[API](https://skmtc.dev/whitepages/apis/whitepages-api-reference.md) · [All operations](https://skmtc.dev/whitepages/apis/whitepages-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/whitepages/whitepages-api-reference/revisions/c27a0cd8718f/schema)