---
title: "The places in an open region, across hosts – priced for a stay when dates are given"
method: GET
path: "/api/public/v1/network/regions/{slug}/places"
---

# The places in an open region, across hosts – priced for a stay when dates are given

`GET /api/public/v1/network/regions/{slug}/places`

## Request

- Base URL: `https://posadita.com`
- URL: `https://posadita.com/api/public/v1/network/regions/{slug}/places`
- Auth: none declared

## Path parameters

- `slug` string, required

## Query parameters

- `place` string
- `from` string, date
- `to` string, date
- `guests` integer
- `sort` 'recommended' | 'price_asc' | 'price_desc' | 'size'
- `type` string
- `minBedrooms` integer
- `amenities` string
- `availableOnly` boolean
- `limit` integer
- `offset` integer

## Response `200`

The places, one page of them.

- object
  - `region` object
    - `slug` string
    - `name` string
    - `country` string, nullable
  - `place` string, nullable
  - `sites` object[]: Communities and portfolios with a place in this result.
    - `slug` string
    - `name` string
    - `kind` 'community' | 'portfolio'
    - `locality` string, nullable
    - `regionSlug` string, nullable
    - `url` string, uri: The site itself.
    - `coverUrl` string, nullable
    - `logoUrl` string, nullable
    - `placeCount` integer
    - `placesHere` integer
    - `freeHere` integer, nullable
  - `search` object, nullable
    - `from` string, date
    - `to` string, date
    - `guests` integer
  - `sort` string
  - `total` integer
  - `available` integer, nullable
  - `offset` integer
  - `limit` integer
  - `places` object[]: Bookable places first (free, then taken), then listings, then places not online yet.
    - `propertyId` string
    - `slug` string, nullable
    - `name` string
    - `url` string, nullable: The place's own page – null only when it is not online yet.
    - `state` 'bookable' | 'listing' | 'unpublished'
    - `propertyType` string
    - `headline` string, nullable
    - `locality` string, nullable
    - `photoUrl` string, nullable
    - `maxGuests` integer, nullable
    - `bedrooms` integer, nullable
    - `beds` integer, nullable
    - `sizeM2` integer, nullable
    - `amenities` string[]
    - `available` boolean, nullable: For the dates asked; null without dates.
    - `currency` string: ISO 4217
    - `totalCents` integer, nullable: The whole stay as get_quote prices it; null without dates, when it cannot be booked, and always on a listing.
    - `nights` integer, nullable
    - `fromNightlyCents` integer, nullable: Lowest nightly rate; bookable places only.
    - `rejection` object, nullable
      - `reason` string
      - `minStay` integer
      - `maxGuests` integer
    - `position` object, nullable: Rounded when the host keeps the address private (`pinPrecision: area`).
      - `lat` number
      - `lng` number
    - `pinPrecision` 'exact' | 'area' | 'null', nullable
    - `partOf` object, nullable: A community or portfolio the place is on.
      - `slug` string
      - `name` string
      - `kind` 'community' | 'portfolio'

## Other responses

- `400`: from/to unusable
- `404`: No OPEN region has this slug – regions are opened by hand, and a region that is not open has no places to list

---

[API](https://skmtc.dev/posadita/apis/posadita-direct-booking.md) · [All operations](https://skmtc.dev/posadita/apis/posadita-direct-booking/llms.txt) · [OpenAPI document](https://skmtc.dev/posadita/apis/posadita-direct-booking/revisions/5a4a24c27407?raw)