Snapshot d'un séjour (statut, unité, folioId, meal-plan, headcount, dates)

GET

/v1/stays/{id}

curl --request GET \
  --url https://example.com/v1/stays/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0 \
  --header 'X-API-Key: <X-API-Key>'

Retourne une projection read-side du séjour identifié par son UUID. Données délibérément minimales (published language RGPD — pas d’email/identité guest directs). IDOR : accès vérifié contre l’établissement réel du séjour.

Authorizations

• ApiKeyAuth
• BearerAuth

Parameters

Path Parameters

id

required

string format: uuid

UUID du séjour

Responses

200

Snapshot du séjour

Media type application/json

object

data

required

object

id

required

string format: uuid

status

required

string

Allowed values: checked_in checked_out

establishmentId

required

string format: uuid

reservationId

required

string format: uuid

currentUnitId

required

string format: uuid

guestProfileId

required

string format: uuid

folioId

required

string format: uuid

headcountAdults

required

integer

headcountChildren

required

integer

headcountTotal

required

integer

checkedInAt

required

string format: date-time

checkedOutAt

string format: date-time

nullable

mealPlanId

Identifiant opaque du plan repas (null si aucun)

string

nullable

Example

{
  "data": {
    "status": "checked_in"
  }
}

401

Non authentifié

Media type 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 ou périmètre hors scope

Media type 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
}

404

Séjour introuvable

Media type 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
}