Émargement — référence de l’API v1

Sessions de formation, créneaux, feuille scellée. Référence générée depuis les schémas de validation de l’API : ce que vous lisez est ce que le serveur vérifie.

post/attendance-sessions — Créer une session d’émargement
get/attendance-sessions — Lister les sessions
get/attendance-sessions/{id} — Lire une session (présences en temps réel)
post/attendance-sessions/{id}/attendees — Ajouter un inscrit en cours de session
post/attendance-sessions/{id}/slots/{slotId}/open — Ouvrir un créneau
post/attendance-sessions/{id}/slots/{slotId}/close — Fermer un créneau
post/attendance-sessions/{id}/close — Clôturer la session
get/attendance-sessions/{id}/sheet — Feuille scellée (lien 1 h)
get/attendance-sessions/{id}/export — Export CSV pour le contrôle de service fait

Base : https://preprod-app.signatik.com/api/v1 · authentification Authorization: Bearer sk_… · erreurs { "error": { "code", "message" } }.

post/api/v1/attendance-sessions

Créer une session d’émargement

Aucun PDF en entrée : la feuille est générée par la plateforme. Réponse : sign_url par stagiaire, trainer.url pour le formateur. Scope attendance:write.

●POST /attendance-sessions

curl -X POST https://preprod-app.signatik.com/api/v1/attendance-sessions \
  -H "Authorization: Bearer sk_test_…" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Contrat de mission n°1234",
  "reference": "SESS-2026-0912",
  "modality": "onsite",
  "location": "Lyon, salle 3",
  "trainer": {
    "name": "Contrat de mission n°1234"
  },
  "slots": [
    {
      "label": "Jour 1 — matin",
      "starts_at": "2026-09-15T09:00:00+02:00",
      "ends_at": "2026-09-15T12:30:00+02:00"
    }
  ],
  "attendees": [
    {
      "name": "Contrat de mission n°1234"
    }
  ],
  "retention_days": 1095,
  "notify": true
}'

●201 — exemple de réponse

{
  "id": "8f2c1d4e-0b7a-4c1e-9f0d-6a3b2c1d0e9f",
  "name": "Contrat de mission n°1234",
  "reference": "SESS-2026-0912",
  "modality": "onsite",
  "location": "Lyon, salle 3",
  "status": "open",
  "trainer": {
    "name": "Contrat de mission n°1234",
    "email": "jean.dupont@exemple.fr",
    "url": "https://votre-app.fr/webhooks/esign"
  },
  "retention_days": 1,
  "created_at": "…",
  "closed_at": "2026-09-02T14:33:07Z",
  "sealed_at": "2026-09-02T14:33:07Z",
  "sheet_sha256": "…",
  "sheet_download_url": "…",
  "evidence_download_url": "…",
  "slots": [
    {
      "id": "8f2c1d4e-0b7a-4c1e-9f0d-6a3b2c1d0e9f",
      "label": "Jour 1 — matin",
      "starts_at": "2026-09-15T09:00:00+02:00",
      "ends_at": "2026-09-15T12:30:00+02:00",
      "module": "…",
      "status": "scheduled",
      "opened_at": "2026-09-02T14:33:07Z",
      "closed_at": "2026-09-02T14:33:07Z",
      "trainer_signed_at": "2026-09-02T14:33:07Z",
      "present": 1,
      "expected": 1,
      "rate": 1
    }
  ],
  "attendees": [
    {
      "id": "8f2c1d4e-0b7a-4c1e-9f0d-6a3b2c1d0e9f",
      "name": "Contrat de mission n°1234",
      "email": "jean.dupont@exemple.fr",
      "external_ref": "STG-8891",
      "sign_url": "…",
      "marks": [
        {
          "slot_id": "8f2c1d4e-0b7a-4c1e-9f0d-6a3b2c1d0e9f",
          "status": "…",
          "method": "…",
          "signed_at": "…",
          "out_of_window": true
        }
      ]
    }
  ],
  "marks_count": 1
}

Corps de la requête

Champ	Type	Description
`name`requis	string	≤ 200 car.
`reference`	string	≤ 100 car.
`modality`	"onsite" \| "remote" \| "hybrid"	défaut : "onsite"
`location`	string	≤ 200 car.
`trainer`requis	object
`name`requis	string	≤ 200 car.
`email`	string
`slots`requis	object[]	1–200 éléments
`label`requis	string	≤ 100 car.
`starts_at`requis	date-time
`ends_at`requis	date-time
`module`	string	≤ 200 car.
`attendees`requis	object[]	1–500 éléments
`name`requis	string	≤ 200 car.
`email`	string
`external_ref`	string	≤ 100 car.
`retention_days`	integer	défaut : 1095 · 30–3650
`notify`	boolean	défaut : true

Réponses

`201`	OK
`400`	Corps invalide
`401`	Clé absente, mal formée ou révoquée (`unauthorized`)
`403`	Scope manquant sur la clé (`forbidden`)
`429`	Limitation de débit (`rate_limited`, en-tête `Retry-After`)

Réponse 201

Champ	Type	Description
`id`requis	uuid
`name`requis	string
`reference`requis	string \| null
`modality`requis	"onsite" \| "remote" \| "hybrid"
`location`requis	string \| null
`status`requis	"open" \| "closed" \| "sealed"
`trainer`requis	object
`name`requis	string
`email`requis	string \| null
`url`requis	string	Espace formateur (ouverture et fermeture des créneaux, QR code)
`retention_days`requis	integer
`created_at`requis	string
`closed_at`requis	date-time \| null
`sealed_at`requis	date-time \| null
`sheet_sha256`requis	string \| null
`sheet_download_url`requis	string \| null
`evidence_download_url`requis	string \| null
`slots`requis	object[]
`id`requis	uuid
`label`requis	string
`starts_at`requis	string
`ends_at`requis	string
`module`requis	string \| null
`status`requis	"scheduled" \| "open" \| "closed"
`opened_at`requis	date-time \| null
`closed_at`requis	date-time \| null
`trainer_signed_at`requis	date-time \| null
`present`requis	integer
`expected`requis	integer
`rate`requis	integer	Taux de présence, en %
`attendees`requis	object[]
`id`requis	uuid
`name`requis	string
`email`requis	string \| null
`external_ref`requis	string \| null
`sign_url`requis	string	Lien personnel d’émargement, valable toute la session
`marks`requis	object[]
`slot_id`requis	uuid
`status`requis	string
`method`requis	string
`signed_at`requis	string
`out_of_window`requis	boolean
`marks_count`requis	integer

get/api/v1/attendance-sessions

Lister les sessions

●GET /attendance-sessions

curl -X GET https://preprod-app.signatik.com/api/v1/attendance-sessions \
  -H "Authorization: Bearer sk_test_…"

●200 — exemple de réponse

{
  "data": [
    {
      "id": "8f2c1d4e-0b7a-4c1e-9f0d-6a3b2c1d0e9f",
      "name": "Contrat de mission n°1234",
      "reference": "SESS-2026-0912",
      "status": "…",
      "created_at": "…"
    }
  ],
  "limit": 1,
  "offset": 1
}

Paramètres de requête

`limit`	integer
`offset`	integer \| null

Réponses

`200`	OK
`401`	Clé absente, mal formée ou révoquée (`unauthorized`)
`403`	Scope manquant sur la clé (`forbidden`)
`429`	Limitation de débit (`rate_limited`, en-tête `Retry-After`)

Réponse 200

Champ	Type	Description
`data`requis	object[]
`id`requis	uuid
`name`requis	string
`reference`requis	string \| null
`status`requis	string
`created_at`requis	string
`limit`requis	number
`offset`requis	number

get/api/v1/attendance-sessions/{id}

Lire une session (présences en temps réel)

●GET /attendance-sessions/{id}

curl -X GET https://preprod-app.signatik.com/api/v1/attendance-sessions/env_8f2c… \
  -H "Authorization: Bearer sk_test_…"

●200 — exemple de réponse

{
  "id": "8f2c1d4e-0b7a-4c1e-9f0d-6a3b2c1d0e9f",
  "name": "Contrat de mission n°1234",
  "reference": "SESS-2026-0912",
  "modality": "onsite",
  "location": "Lyon, salle 3",
  "status": "open",
  "trainer": {
    "name": "Contrat de mission n°1234",
    "email": "jean.dupont@exemple.fr",
    "url": "https://votre-app.fr/webhooks/esign"
  },
  "retention_days": 1,
  "created_at": "…",
  "closed_at": "2026-09-02T14:33:07Z",
  "sealed_at": "2026-09-02T14:33:07Z",
  "sheet_sha256": "…",
  "sheet_download_url": "…",
  "evidence_download_url": "…",
  "slots": [
    {
      "id": "8f2c1d4e-0b7a-4c1e-9f0d-6a3b2c1d0e9f",
      "label": "Jour 1 — matin",
      "starts_at": "2026-09-15T09:00:00+02:00",
      "ends_at": "2026-09-15T12:30:00+02:00",
      "module": "…",
      "status": "scheduled",
      "opened_at": "2026-09-02T14:33:07Z",
      "closed_at": "2026-09-02T14:33:07Z",
      "trainer_signed_at": "2026-09-02T14:33:07Z",
      "present": 1,
      "expected": 1,
      "rate": 1
    }
  ],
  "attendees": [
    {
      "id": "8f2c1d4e-0b7a-4c1e-9f0d-6a3b2c1d0e9f",
      "name": "Contrat de mission n°1234",
      "email": "jean.dupont@exemple.fr",
      "external_ref": "STG-8891",
      "sign_url": "…",
      "marks": [
        {
          "slot_id": "8f2c1d4e-0b7a-4c1e-9f0d-6a3b2c1d0e9f",
          "status": "…",
          "method": "…",
          "signed_at": "…",
          "out_of_window": true
        }
      ]
    }
  ],
  "marks_count": 1
}

Paramètres de chemin

id uuid

Réponses

`200`	OK
`401`	Clé absente, mal formée ou révoquée (`unauthorized`)
`403`	Scope manquant sur la clé (`forbidden`)
`404`	Introuvable
`429`	Limitation de débit (`rate_limited`, en-tête `Retry-After`)

Réponse 200

Champ	Type	Description
`id`requis	uuid
`name`requis	string
`reference`requis	string \| null
`modality`requis	"onsite" \| "remote" \| "hybrid"
`location`requis	string \| null
`status`requis	"open" \| "closed" \| "sealed"
`trainer`requis	object
`name`requis	string
`email`requis	string \| null
`url`requis	string	Espace formateur (ouverture et fermeture des créneaux, QR code)
`retention_days`requis	integer
`created_at`requis	string
`closed_at`requis	date-time \| null
`sealed_at`requis	date-time \| null
`sheet_sha256`requis	string \| null
`sheet_download_url`requis	string \| null
`evidence_download_url`requis	string \| null
`slots`requis	object[]
`id`requis	uuid
`label`requis	string
`starts_at`requis	string
`ends_at`requis	string
`module`requis	string \| null
`status`requis	"scheduled" \| "open" \| "closed"
`opened_at`requis	date-time \| null
`closed_at`requis	date-time \| null
`trainer_signed_at`requis	date-time \| null
`present`requis	integer
`expected`requis	integer
`rate`requis	integer	Taux de présence, en %
`attendees`requis	object[]
`id`requis	uuid
`name`requis	string
`email`requis	string \| null
`external_ref`requis	string \| null
`sign_url`requis	string	Lien personnel d’émargement, valable toute la session
`marks`requis	object[]
`slot_id`requis	uuid
`status`requis	string
`method`requis	string
`signed_at`requis	string
`out_of_window`requis	boolean
`marks_count`requis	integer

post/api/v1/attendance-sessions/{id}/attendees

Ajouter un inscrit en cours de session

●POST /attendance-sessions/{id}/attendees

curl -X POST https://preprod-app.signatik.com/api/v1/attendance-sessions/env_8f2c…/attendees \
  -H "Authorization: Bearer sk_test_…" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Contrat de mission n°1234",
  "email": "jean.dupont@exemple.fr",
  "external_ref": "STG-8891"
}'

●201 — exemple de réponse

{
  "id": "8f2c1d4e-0b7a-4c1e-9f0d-6a3b2c1d0e9f",
  "name": "Contrat de mission n°1234",
  "reference": "SESS-2026-0912",
  "modality": "onsite",
  "location": "Lyon, salle 3",
  "status": "open",
  "trainer": {
    "name": "Contrat de mission n°1234",
    "email": "jean.dupont@exemple.fr",
    "url": "https://votre-app.fr/webhooks/esign"
  },
  "retention_days": 1,
  "created_at": "…",
  "closed_at": "2026-09-02T14:33:07Z",
  "sealed_at": "2026-09-02T14:33:07Z",
  "sheet_sha256": "…",
  "sheet_download_url": "…",
  "evidence_download_url": "…",
  "slots": [
    {
      "id": "8f2c1d4e-0b7a-4c1e-9f0d-6a3b2c1d0e9f",
      "label": "Jour 1 — matin",
      "starts_at": "2026-09-15T09:00:00+02:00",
      "ends_at": "2026-09-15T12:30:00+02:00",
      "module": "…",
      "status": "scheduled",
      "opened_at": "2026-09-02T14:33:07Z",
      "closed_at": "2026-09-02T14:33:07Z",
      "trainer_signed_at": "2026-09-02T14:33:07Z",
      "present": 1,
      "expected": 1,
      "rate": 1
    }
  ],
  "attendees": [
    {
      "id": "8f2c1d4e-0b7a-4c1e-9f0d-6a3b2c1d0e9f",
      "name": "Contrat de mission n°1234",
      "email": "jean.dupont@exemple.fr",
      "external_ref": "STG-8891",
      "sign_url": "…",
      "marks": [
        {
          "slot_id": "8f2c1d4e-0b7a-4c1e-9f0d-6a3b2c1d0e9f",
          "status": "…",
          "method": "…",
          "signed_at": "…",
          "out_of_window": true
        }
      ]
    }
  ],
  "marks_count": 1
}

Paramètres de chemin

id uuid

Corps de la requête

Champ	Type	Description
`name`requis	string	≤ 200 car.
`email`	string
`external_ref`	string	≤ 100 car.

Réponses

`201`	OK
`400`	`name` requis
`401`	Clé absente, mal formée ou révoquée (`unauthorized`)
`403`	Scope manquant sur la clé (`forbidden`)
`404`	Introuvable
`409`	Session close
`429`	Limitation de débit (`rate_limited`, en-tête `Retry-After`)

Réponse 201

Champ	Type	Description
`id`requis	uuid
`name`requis	string
`reference`requis	string \| null
`modality`requis	"onsite" \| "remote" \| "hybrid"
`location`requis	string \| null
`status`requis	"open" \| "closed" \| "sealed"
`trainer`requis	object
`name`requis	string
`email`requis	string \| null
`url`requis	string	Espace formateur (ouverture et fermeture des créneaux, QR code)
`retention_days`requis	integer
`created_at`requis	string
`closed_at`requis	date-time \| null
`sealed_at`requis	date-time \| null
`sheet_sha256`requis	string \| null
`sheet_download_url`requis	string \| null
`evidence_download_url`requis	string \| null
`slots`requis	object[]
`id`requis	uuid
`label`requis	string
`starts_at`requis	string
`ends_at`requis	string
`module`requis	string \| null
`status`requis	"scheduled" \| "open" \| "closed"
`opened_at`requis	date-time \| null
`closed_at`requis	date-time \| null
`trainer_signed_at`requis	date-time \| null
`present`requis	integer
`expected`requis	integer
`rate`requis	integer	Taux de présence, en %
`attendees`requis	object[]
`id`requis	uuid
`name`requis	string
`email`requis	string \| null
`external_ref`requis	string \| null
`sign_url`requis	string	Lien personnel d’émargement, valable toute la session
`marks`requis	object[]
`slot_id`requis	uuid
`status`requis	string
`method`requis	string
`signed_at`requis	string
`out_of_window`requis	boolean
`marks_count`requis	integer

post/api/v1/attendance-sessions/{id}/slots/{slotId}/open

Ouvrir un créneau

Le QR code n’existe qu’entre l’ouverture et la fermeture.

●POST /attendance-sessions/{id}/slots/{slotId}/open

curl -X POST https://preprod-app.signatik.com/api/v1/attendance-sessions/env_8f2c…/slots/slt_…/open \
  -H "Authorization: Bearer sk_test_…"

●200 — exemple de réponse

{
  "id": "8f2c1d4e-0b7a-4c1e-9f0d-6a3b2c1d0e9f",
  "name": "Contrat de mission n°1234",
  "reference": "SESS-2026-0912",
  "modality": "onsite",
  "location": "Lyon, salle 3",
  "status": "open",
  "trainer": {
    "name": "Contrat de mission n°1234",
    "email": "jean.dupont@exemple.fr",
    "url": "https://votre-app.fr/webhooks/esign"
  },
  "retention_days": 1,
  "created_at": "…",
  "closed_at": "2026-09-02T14:33:07Z",
  "sealed_at": "2026-09-02T14:33:07Z",
  "sheet_sha256": "…",
  "sheet_download_url": "…",
  "evidence_download_url": "…",
  "slots": [
    {
      "id": "8f2c1d4e-0b7a-4c1e-9f0d-6a3b2c1d0e9f",
      "label": "Jour 1 — matin",
      "starts_at": "2026-09-15T09:00:00+02:00",
      "ends_at": "2026-09-15T12:30:00+02:00",
      "module": "…",
      "status": "scheduled",
      "opened_at": "2026-09-02T14:33:07Z",
      "closed_at": "2026-09-02T14:33:07Z",
      "trainer_signed_at": "2026-09-02T14:33:07Z",
      "present": 1,
      "expected": 1,
      "rate": 1
    }
  ],
  "attendees": [
    {
      "id": "8f2c1d4e-0b7a-4c1e-9f0d-6a3b2c1d0e9f",
      "name": "Contrat de mission n°1234",
      "email": "jean.dupont@exemple.fr",
      "external_ref": "STG-8891",
      "sign_url": "…",
      "marks": [
        {
          "slot_id": "8f2c1d4e-0b7a-4c1e-9f0d-6a3b2c1d0e9f",
          "status": "…",
          "method": "…",
          "signed_at": "…",
          "out_of_window": true
        }
      ]
    }
  ],
  "marks_count": 1
}

Paramètres de chemin

`id`	uuid
`slotId`	uuid

Réponses

`200`	OK
`401`	Clé absente, mal formée ou révoquée (`unauthorized`)
`403`	Scope manquant sur la clé (`forbidden`)
`404`	Introuvable
`409`	`slot_closed`
`429`	Limitation de débit (`rate_limited`, en-tête `Retry-After`)

Réponse 200

Champ	Type	Description
`id`requis	uuid
`name`requis	string
`reference`requis	string \| null
`modality`requis	"onsite" \| "remote" \| "hybrid"
`location`requis	string \| null
`status`requis	"open" \| "closed" \| "sealed"
`trainer`requis	object
`name`requis	string
`email`requis	string \| null
`url`requis	string	Espace formateur (ouverture et fermeture des créneaux, QR code)
`retention_days`requis	integer
`created_at`requis	string
`closed_at`requis	date-time \| null
`sealed_at`requis	date-time \| null
`sheet_sha256`requis	string \| null
`sheet_download_url`requis	string \| null
`evidence_download_url`requis	string \| null
`slots`requis	object[]
`id`requis	uuid
`label`requis	string
`starts_at`requis	string
`ends_at`requis	string
`module`requis	string \| null
`status`requis	"scheduled" \| "open" \| "closed"
`opened_at`requis	date-time \| null
`closed_at`requis	date-time \| null
`trainer_signed_at`requis	date-time \| null
`present`requis	integer
`expected`requis	integer
`rate`requis	integer	Taux de présence, en %
`attendees`requis	object[]
`id`requis	uuid
`name`requis	string
`email`requis	string \| null
`external_ref`requis	string \| null
`sign_url`requis	string	Lien personnel d’émargement, valable toute la session
`marks`requis	object[]
`slot_id`requis	uuid
`status`requis	string
`method`requis	string
`signed_at`requis	string
`out_of_window`requis	boolean
`marks_count`requis	integer

post/api/v1/attendance-sessions/{id}/slots/{slotId}/close

Fermer un créneau

Un créneau clos ne peut plus être rempli, jamais.

●POST /attendance-sessions/{id}/slots/{slotId}/close

curl -X POST https://preprod-app.signatik.com/api/v1/attendance-sessions/env_8f2c…/slots/slt_…/close \
  -H "Authorization: Bearer sk_test_…"

●200 — exemple de réponse

{
  "id": "8f2c1d4e-0b7a-4c1e-9f0d-6a3b2c1d0e9f",
  "name": "Contrat de mission n°1234",
  "reference": "SESS-2026-0912",
  "modality": "onsite",
  "location": "Lyon, salle 3",
  "status": "open",
  "trainer": {
    "name": "Contrat de mission n°1234",
    "email": "jean.dupont@exemple.fr",
    "url": "https://votre-app.fr/webhooks/esign"
  },
  "retention_days": 1,
  "created_at": "…",
  "closed_at": "2026-09-02T14:33:07Z",
  "sealed_at": "2026-09-02T14:33:07Z",
  "sheet_sha256": "…",
  "sheet_download_url": "…",
  "evidence_download_url": "…",
  "slots": [
    {
      "id": "8f2c1d4e-0b7a-4c1e-9f0d-6a3b2c1d0e9f",
      "label": "Jour 1 — matin",
      "starts_at": "2026-09-15T09:00:00+02:00",
      "ends_at": "2026-09-15T12:30:00+02:00",
      "module": "…",
      "status": "scheduled",
      "opened_at": "2026-09-02T14:33:07Z",
      "closed_at": "2026-09-02T14:33:07Z",
      "trainer_signed_at": "2026-09-02T14:33:07Z",
      "present": 1,
      "expected": 1,
      "rate": 1
    }
  ],
  "attendees": [
    {
      "id": "8f2c1d4e-0b7a-4c1e-9f0d-6a3b2c1d0e9f",
      "name": "Contrat de mission n°1234",
      "email": "jean.dupont@exemple.fr",
      "external_ref": "STG-8891",
      "sign_url": "…",
      "marks": [
        {
          "slot_id": "8f2c1d4e-0b7a-4c1e-9f0d-6a3b2c1d0e9f",
          "status": "…",
          "method": "…",
          "signed_at": "…",
          "out_of_window": true
        }
      ]
    }
  ],
  "marks_count": 1
}

Paramètres de chemin

`id`	uuid
`slotId`	uuid

Réponses

`200`	OK
`401`	Clé absente, mal formée ou révoquée (`unauthorized`)
`403`	Scope manquant sur la clé (`forbidden`)
`404`	Introuvable
`409`	`invalid_status`
`429`	Limitation de débit (`rate_limited`, en-tête `Retry-After`)

Réponse 200

Champ	Type	Description
`id`requis	uuid
`name`requis	string
`reference`requis	string \| null
`modality`requis	"onsite" \| "remote" \| "hybrid"
`location`requis	string \| null
`status`requis	"open" \| "closed" \| "sealed"
`trainer`requis	object
`name`requis	string
`email`requis	string \| null
`url`requis	string	Espace formateur (ouverture et fermeture des créneaux, QR code)
`retention_days`requis	integer
`created_at`requis	string
`closed_at`requis	date-time \| null
`sealed_at`requis	date-time \| null
`sheet_sha256`requis	string \| null
`sheet_download_url`requis	string \| null
`evidence_download_url`requis	string \| null
`slots`requis	object[]
`id`requis	uuid
`label`requis	string
`starts_at`requis	string
`ends_at`requis	string
`module`requis	string \| null
`status`requis	"scheduled" \| "open" \| "closed"
`opened_at`requis	date-time \| null
`closed_at`requis	date-time \| null
`trainer_signed_at`requis	date-time \| null
`present`requis	integer
`expected`requis	integer
`rate`requis	integer	Taux de présence, en %
`attendees`requis	object[]
`id`requis	uuid
`name`requis	string
`email`requis	string \| null
`external_ref`requis	string \| null
`sign_url`requis	string	Lien personnel d’émargement, valable toute la session
`marks`requis	object[]
`slot_id`requis	uuid
`status`requis	string
`method`requis	string
`signed_at`requis	string
`out_of_window`requis	boolean
`marks_count`requis	integer

post/api/v1/attendance-sessions/{id}/close

Clôturer la session

Feuille générée, un seul scellement, un seul dossier de preuve, webhook attendance.session_closed. Irréversible.

●POST /attendance-sessions/{id}/close

curl -X POST https://preprod-app.signatik.com/api/v1/attendance-sessions/env_8f2c…/close \
  -H "Authorization: Bearer sk_test_…"

●200 — exemple de réponse

{
  "id": "8f2c1d4e-0b7a-4c1e-9f0d-6a3b2c1d0e9f",
  "name": "Contrat de mission n°1234",
  "reference": "SESS-2026-0912",
  "modality": "onsite",
  "location": "Lyon, salle 3",
  "status": "open",
  "trainer": {
    "name": "Contrat de mission n°1234",
    "email": "jean.dupont@exemple.fr",
    "url": "https://votre-app.fr/webhooks/esign"
  },
  "retention_days": 1,
  "created_at": "…",
  "closed_at": "2026-09-02T14:33:07Z",
  "sealed_at": "2026-09-02T14:33:07Z",
  "sheet_sha256": "…",
  "sheet_download_url": "…",
  "evidence_download_url": "…",
  "slots": [
    {
      "id": "8f2c1d4e-0b7a-4c1e-9f0d-6a3b2c1d0e9f",
      "label": "Jour 1 — matin",
      "starts_at": "2026-09-15T09:00:00+02:00",
      "ends_at": "2026-09-15T12:30:00+02:00",
      "module": "…",
      "status": "scheduled",
      "opened_at": "2026-09-02T14:33:07Z",
      "closed_at": "2026-09-02T14:33:07Z",
      "trainer_signed_at": "2026-09-02T14:33:07Z",
      "present": 1,
      "expected": 1,
      "rate": 1
    }
  ],
  "attendees": [
    {
      "id": "8f2c1d4e-0b7a-4c1e-9f0d-6a3b2c1d0e9f",
      "name": "Contrat de mission n°1234",
      "email": "jean.dupont@exemple.fr",
      "external_ref": "STG-8891",
      "sign_url": "…",
      "marks": [
        {
          "slot_id": "8f2c1d4e-0b7a-4c1e-9f0d-6a3b2c1d0e9f",
          "status": "…",
          "method": "…",
          "signed_at": "…",
          "out_of_window": true
        }
      ]
    }
  ],
  "marks_count": 1
}

Paramètres de chemin

id uuid

Réponses

`200`	OK
`401`	Clé absente, mal formée ou révoquée (`unauthorized`)
`403`	Scope manquant sur la clé (`forbidden`)
`404`	Introuvable
`409`	`invalid_status`
`429`	Limitation de débit (`rate_limited`, en-tête `Retry-After`)

Réponse 200

Champ	Type	Description
`id`requis	uuid
`name`requis	string
`reference`requis	string \| null
`modality`requis	"onsite" \| "remote" \| "hybrid"
`location`requis	string \| null
`status`requis	"open" \| "closed" \| "sealed"
`trainer`requis	object
`name`requis	string
`email`requis	string \| null
`url`requis	string	Espace formateur (ouverture et fermeture des créneaux, QR code)
`retention_days`requis	integer
`created_at`requis	string
`closed_at`requis	date-time \| null
`sealed_at`requis	date-time \| null
`sheet_sha256`requis	string \| null
`sheet_download_url`requis	string \| null
`evidence_download_url`requis	string \| null
`slots`requis	object[]
`id`requis	uuid
`label`requis	string
`starts_at`requis	string
`ends_at`requis	string
`module`requis	string \| null
`status`requis	"scheduled" \| "open" \| "closed"
`opened_at`requis	date-time \| null
`closed_at`requis	date-time \| null
`trainer_signed_at`requis	date-time \| null
`present`requis	integer
`expected`requis	integer
`rate`requis	integer	Taux de présence, en %
`attendees`requis	object[]
`id`requis	uuid
`name`requis	string
`email`requis	string \| null
`external_ref`requis	string \| null
`sign_url`requis	string	Lien personnel d’émargement, valable toute la session
`marks`requis	object[]
`slot_id`requis	uuid
`status`requis	string
`method`requis	string
`signed_at`requis	string
`out_of_window`requis	boolean
`marks_count`requis	integer

get/api/v1/attendance-sessions/{id}/sheet

Feuille scellée (lien 1 h)

●GET /attendance-sessions/{id}/sheet

curl -X GET https://preprod-app.signatik.com/api/v1/attendance-sessions/env_8f2c…/sheet \
  -H "Authorization: Bearer sk_test_…"

●200 — exemple de réponse

{
  "sheet_sha256": "…",
  "sheet_download_url": "…",
  "evidence_download_url": "…"
}

Paramètres de chemin

id uuid

Réponses

`200`	OK
`401`	Clé absente, mal formée ou révoquée (`unauthorized`)
`403`	Scope manquant sur la clé (`forbidden`)
`404`	Introuvable
`409`	Pas encore scellée
`410`	Feuille purgée (fin de rétention)
`429`	Limitation de débit (`rate_limited`, en-tête `Retry-After`)

Réponse 200

Champ	Type	Description
`sheet_sha256`requis	string \| null
`sheet_download_url`requis	string
`evidence_download_url`requis	string \| null

get/api/v1/attendance-sessions/{id}/export

Export CSV pour le contrôle de service fait

●GET /attendance-sessions/{id}/export

curl -X GET https://preprod-app.signatik.com/api/v1/attendance-sessions/env_8f2c…/export \
  -H "Authorization: Bearer sk_test_…"

Paramètres de chemin

id uuid

Paramètres de requête

format "csv"

Réponses

`200`	CSV (séparateur `;`)
`401`	Clé absente, mal formée ou révoquée (`unauthorized`)
`403`	Scope manquant sur la clé (`forbidden`)
`404`	Introuvable
`429`	Limitation de débit (`rate_limited`, en-tête `Retry-After`)