Couverts cuisine prévisionnels pour une date de service (MP-6b)

GET

/v1/establishments/{id}/meal-covers

curl --request GET \
  --url 'https://example.com/v1/establishments/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/meal-covers?serviceDate=2026-06-20' \
  --header 'X-API-Key: <X-API-Key>'

Retourne le nombre de couverts par repas (breakfast/lunch/dinner) pour la date de service D, calculés à la demande depuis les séjours in-house et leurs schedules. Convention NUITÉE A : breakfast(D) = séjours in-house la nuit D−1.

Authorizations

• ApiKeyAuth
• BearerAuth

Parameters

Path Parameters

id

required

string format: uuid

Identifiant de l’établissement

Query Parameters

byStay

boolean

Si true, retourne le détail des couverts par séjour

serviceDate

required

string format: date

Example

2026-06-20

Date de service calendaire (YYYY-MM-DD)

Responses

200

Couverts cuisine prévisionnels pour la date demandée

Media type application/json

object

data

required

object

serviceDate

required

Date de service calendaire (YYYY-MM-DD)

string format: date

covers

required

object

breakfast

required

Couverts petit-déjeuner (convention A : nuit D−1)

integer

lunch

required

Couverts déjeuner (nuit D)

integer

dinner

required

Couverts dîner (nuit D)

integer

byStay

Détail des couverts par séjour (présent si byStay=true)

Array<object>

object

stayId

required

Identifiant du séjour

string format: uuid

breakfast

required

integer

lunch

required

integer

dinner

required

integer

Example

{
  "data": {
    "serviceDate": "2026-06-20"
  }
}

400

ServiceDate invalide ou paramètre manquant

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
}

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 (stay.meal_plan) ou IDOR établissement

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
}