---
title: "Get Agent Properties"
method: POST
path: "/getProperties"
tags: ["Properties"]
---

# Get Agent Properties

`POST /getProperties`

## Request

- Base URL: `https://ws.spac.io/api/v1`
- URL: `https://ws.spac.io/api/v1/getProperties`
- Auth: none declared. Required headers: `apikey`

Retrieve a list of properties associated with an agent. Returns paginated results of all properties the agent manages.

## Headers

- `apikey` string, required

## Response `200`

Successful response with agent properties

- PropertiesResponse
  - `success` boolean
  - `data` Property[]
    - `property_id` string: Unique property identifier
    - `address` string: Street address
    - `city` string
    - `state` string: Two-letter state code
    - `zip` string
    - `price` number, double: List price in USD
    - `bedrooms` integer
    - `bathrooms` number: Full and half bathrooms
    - `sqft` integer: Square footage
    - `status` 'active' | 'pending' | 'sold' | 'expired' | 'withdrawn': Current listing status
    - `list_date` string, date: Date property was listed
    - `mls_id` string: MLS number
    - `property_type` 'single_family' | 'condo' | 'townhouse' | 'multi_unit' | 'land' | 'commercial': Type of property
    - `lot_size` string: Lot size (e.g., 0.25 acres)
    - `year_built` integer
  - `pagination` object
    - `current_page` integer
    - `total_pages` integer
    - `total_results` integer

## Other responses

- `400`: Bad request - invalid parameters
- `401`: Unauthorized - invalid API key
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/lwolf/apis/spacio-real-estate-api.md) · [All operations](https://skmtc.dev/lwolf/apis/spacio-real-estate-api/llms.txt) · [OpenAPI document](https://skmtc.dev/lwolf/apis/spacio-real-estate-api/revisions/81928c05ecfc?raw)