Hotels

Paginated list of hotels exposed to your partner. Only the company’s own stock appears.

GET/v1/{code}/hotels

Request

Query parameters

Name
city
Type
integer
Description
Filter by city (reference id, see Reference data).
Name
country
Type
integer
Description
Filter by country.
Name
modifiedSince
Type
string
Description
ISO 8601 — only return hotels modified since this date (incremental sync).
Name
page
Type
integer
Description
Page number (default 1).
Name
perPage
Type
integer
Description
Page size (default 50, maximum 100).

GET

/v1/1000/hotels

curl -s "https://partners.bravebooking.net/v1/1000/hotels?city=146070&perPage=50" \
  -H "X-Api-Key: $API_KEY" \
  -H "X-Timestamp: $TIMESTAMP" \
  -H "X-Signature: $SIGNATURE" \
  -H "Accept: application/json"

Response

{
  "data": [
    {
      "id": 1803258,
      "name": "Villa Demo Stays",
      "city": { "id": 146070, "name": "La Marsa" },
      "country": { "id": 227, "name": "Tunisie" },
      "category": "4",
      "address": "12 rue du Lac, La Marsa",
      "image": "https://stage-public.s3.fr-par.scw.cloud/clients/1000/hotels/1803258/thumb.jpg",
      "updatedAt": "2026-11-10T09:00:00+01:00"
    }
  ],
  "meta": { "page": 1, "perPage": 50, "total": 1, "pages": 1 }
}

Full editorial content (description, images, amenities) is read via Hotel detail. Availability and prices come from Availability — never from this list.