Properties

Fetch published property listings with filtering, pagination, and sorting. This is the primary endpoint for building property search experiences.

GET/api/v1/properties

Returns a paginated list of published properties matching the given filters.

Query Parameters

Parameter	Type	Description
`zone`	`string`	Filter by zone slug (e.g., "punta-cana", "cap-cana", "bavaro")
`type`	`string`	Property type: condo, villa, penthouse, townhouse, lot, commercial, hotel-unit
`priceMin`	`number`	Minimum price in USD
`priceMax`	`number`	Maximum price in USD
`bedrooms`	`number`	Minimum number of bedrooms
`page`	`number`	Page number for pagination Default: `1`
`limit`	`number`	Results per page (max: 100) Default: `20`

Headers

Parameter	Type	Description
`X-Api-Key`required	`string`	Your API key. Required for all requests.

Response Fields

propertiesProperty[]Array of property objects

totalnumberTotal matching properties across all pages

pagenumberCurrent page number

hasMorebooleanWhether more pages are available

Property Object

idstringUnique property ID

publicIdstringPublic-facing ID (e.g., "RDR-00142")

titlestringProperty title

slugstringURL-safe slug

pricenumberPrice in original currency

currencystringOriginal currency ("USD", "DOP")

priceUSDnumberPrice converted to USD

statusstringavailable | reserved | sold | pre-sale | under-construction

bedroomsnumberNumber of bedrooms

bathroomsnumberNumber of bathrooms

sqmnumberSize in square meters

zonestringZone slug

coordinates{ lat, lng }Geographic coordinates

imagesstring[]Array of image URLs

thumbnailstringPrimary image URL

developer{ id, name }Developer info (contact details included only with API key)

projectNamestringAssociated project name

amenitiesstring[]List of amenities

aiDescriptionstringAI-generated property description

investmentScorenumberAI-calculated investment score (0-100)

Examples

Condos in Punta Cana under $250K

bash

curl "https://reppingdr.com/api/v1/properties?zone=punta-cana&type=condo&priceMax=250000&limit=10"

Response

json

{
  "properties": [
    {
      "id": "abc123",
      "publicId": "RDR-00142",
      "title": "Stunning 2-Bedroom with Pool View",
      "slug": "stunning-2-bedroom-pool-view-punta-cana",
      "price": 185000,
      "currency": "USD",
      "priceUSD": 185000,
      "type": "condo",
      "status": "available",
      "bedrooms": 2,
      "bathrooms": 2,
      "sqm": 95,
      "zone": "punta-cana",
      "coordinates": { "lat": 18.5601, "lng": -68.3725 },
      "images": [
        "https://storage.googleapis.com/reppingdr/properties/abc123/1.jpg"
      ],
      "thumbnail": "https://storage.googleapis.com/reppingdr/properties/abc123/1.jpg",
      "developer": { "id": "dev456", "name": "Blue Ocean Development" },
      "projectName": "Ocean Breeze Residences",
      "amenities": ["pool", "gym", "security", "parking"],
      "aiDescription": "A beautifully designed 2-bedroom condo overlooking...",
      "investmentScore": 78
    }
  ],
  "total": 142,
  "page": 1,
  "hasMore": true
}

Notes

•Only published properties are returned. Draft, rejected, and backlog listings are excluded.
•A valid API key is required for all requests. The developer object includes full contact details (email, phone, WhatsApp) for all paid tiers.
•Prices are always in the property's original currency. Use priceUSD for USD-normalized comparisons.
•The limit parameter is capped at 100 per request.