---
title: "Retrieve a single event by ID"
method: GET
path: "/v1/events/{event_id}"
tags: ["Events"]
---

# Retrieve a single event by ID

`GET /v1/events/{event_id}`

Return a single event by its unique identifier.

## Path parameters

- `event_id` string, required — Unique event identifier

## Response `200`

Event retrieved successfully

- DetailResponseDtoEventResponseDto
  - `result` EventResponseDto, required — Event response envelope.
    - `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

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found
- `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)
