Disponibilité multi-établissements (centrale de résa groupement)

GET

/v1/availability/across-establishments

const url = 'https://example.com/v1/availability/across-establishments?childrenAges=5%2C8&adults=1&checkOutDate=2026-08-08&checkInDate=2026-08-01';
const options = {method: 'GET', headers: {'X-API-Key': '<X-API-Key>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url 'https://example.com/v1/availability/across-establishments?childrenAges=5%2C8&adults=1&checkOutDate=2026-08-08&checkInDate=2026-08-01' \
  --header 'X-API-Key: <X-API-Key>'

SANS establishmentId : recherche sur TOUS les établissements du groupe où le sujet a reservation.read. Pour chacun : meilleure dispo (max sur les types d’unité) + prix « à partir de » (plan éligible le moins cher). Un sujet scopé à un établissement ne voit que celui-ci (IDOR fail-closed). Lecture sans lock. Surface staff-only.

Authorizations

ApiKeyAuth
BearerAuth

Parameters

Query Parameters

bookingDate

Date de la demande (fences lead_time). Défaut = aujourd’hui UTC.

string format: date

childrenAges

Âges des enfants en CSV

string

Example

5,8

adults

integer

default: 1 >= 1 <= 99

checkOutDate

required

string format: date

Example

2026-08-08

checkInDate

required

string format: date

Example

2026-08-01

Responses

200

Disponibilité agrégée par établissement du groupe (uniquement ceux en périmètre)

application/json

object

data

required

Array<object>

object

establishmentId

required

string format: uuid

name

required

Nom commercial de l’établissement

string

propertyType

required

Type de bien (hotel, campsite, …)

string

checkInDate

required

string format: date

checkOutDate

required

string format: date

nights

required

integer

>= 1

availableUnits

required

Meilleure dispo nette (max sur les types d’unité). 0 = complet.

integer

from

required

Prix « à partir de » (plan éligible le moins cher). null = aucun plan chiffrable/éligible.

object

amountCents

required

Total TTC du séjour en centimes (bigint string)

string

currency

required

string

ratePlanId

required

string format: uuid

ratePlanName

required

string

Example

{
  "data": [
    {
      "propertyType": "hotel",
      "from": {
        "currency": "EUR"
      }
    }
  ]
}

400

Paramètres invalides

application/json

object

code

required

Code machine de l’erreur

string

message

required

Message lisible

string

origin

Origine domaine de l’erreur (optionnel)

object

boundedContext

string

module

string

status

required

integer

traceId

required

Identifiant de corrélation pour le support

string

Example

{
  "code": "RESERVATION_NOT_FOUND",
  "message": "Réservation introuvable",
  "status": 404
}

401

Non authentifié

application/json

object

code

required

Code machine de l’erreur

string

message

required

Message lisible

string

origin

Origine domaine de l’erreur (optionnel)

object

boundedContext

string

module

string

status

required

integer

traceId

required

Identifiant de corrélation pour le support

string

Example

{
  "code": "RESERVATION_NOT_FOUND",
  "message": "Réservation introuvable",
  "status": 404
}

403

Permission refusée

application/json

object

code

required

Code machine de l’erreur

string

message

required

Message lisible

string

origin

Origine domaine de l’erreur (optionnel)

object

boundedContext

string

module

string

status

required

integer

traceId

required

Identifiant de corrélation pour le support

string

Example

{
  "code": "RESERVATION_NOT_FOUND",
  "message": "Réservation introuvable",
  "status": 404
}