Journal d'activité de l'établissement (actes de réservation, acteurs résolus)

GET

/v1/activity-journal

curl --request GET \
  --url 'https://example.com/v1/activity-journal?pageSize=25&page=1&to=2026-07-31&from=2026-07-01&establishmentId=2489E9AD-2EE2-8E00-8EC9-32D5F69181C0' \
  --header 'Authorization: Bearer <token>'

Liste paginée des actes journalisés NF203 (reservation_versions), tri anté-chronologique. Fenêtre temporelle OBLIGATOIRE [from, to] ≤ 92 jours (400 sinon). Filtres optionnels : userId (acteur), action (code canonique). Espace MANAGER (permission activity.journal — distincte du flux live activity.read).

Authorizations

• BearerAuth

Parameters

Query Parameters

pageSize

integer

default: 25 >= 1 <= 100

page

integer

default: 1 >= 1

action

string

Filtre code d’acte canonique (valeur inconnue → 0 résultat).

userId

string format: uuid

Filtre acteur (identity_users.id).

to

required

string format: date

Example

2026-07-31

Fenêtre [from, to] incluse, max 92 jours.

from

required

string format: date

Example

2026-07-01

establishmentId

required

string format: uuid

Responses

200

Page du journal d’activité

Media type application/json

object

data

required

Array<object>

object

occurredAt

required

string format: date-time

category

required

Catégorie d’acte (V1 : reservation seul — discriminant d’extension additive).

string

action

required

Code canonique de l’acte (ADR-00D117 A2 — string documentée, PAS un enum de schéma). Codes V1 : create, confirm, cancel, check_in, check_out, close, no_show, walk, modify, reprice, adjust_stay_dates, attach_folio, pre_assign_unit, release_pre_assignment, consume_pre_assignment, individualise_occupant.

string

reason

Motif pur (enum métier, motif canonique de libération, ou texte libre) — null si l’acte n’en porte pas.

string

nullable

modifiedBy

required

Acteur BRUT journalisé (NF203).

string

actorKind

required

Nature de l’acteur résolu (ADR-00D117 A1) — unknown = fail-open d’affichage.

string

Allowed values: user system unknown

actorLabel

required

Libellé d’affichage : email (user), code agent (system), valeur brute (unknown).

string

reservationId

required

string format: uuid

confirmationNumber

N° de confirmation de la réservation (joint page par page) — null si non confirmée.

string

nullable

statusBefore

required

string

statusAfter

required

string

changes

required

Diff field-level complet de l’acte (vue détail dépliable de l’écran Journal — D2).

Array<object>

object

field

required

string

before

required

string

nullable

after

required

string

nullable

meta

required

object

page

required

integer

>= 1

pageSize

required

integer

>= 1

total

required

integer

Example

{
  "data": [
    {
      "actorKind": "user"
    }
  ],
  "meta": {
    "page": 1,
    "pageSize": 20,
    "total": 42
  }
}

400

Corps ou paramètres invalides

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 ou périmètre non vérifiable

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
}