API Skilzy pour les organismes de formation

L'API REST Skilzy permet à ton organisme de récupérer automatiquement les données de tes apprenants (suivi, émargement, évaluations, documents, satisfaction) dans tes propres outils : Airtable, tableurs, ETL, BI. Principalement en lecture ; une opération d'écriture permet aussi d'inscrire un apprenant (clé avec scope « write »). Scopée à ton organisation. Ce sont les mêmes chiffres que les dossiers PDF.

Démarrage rapide

Trois étapes pour ton premier appel :

Génère une clé API depuis la page « API & intégrations » de ton dashboard (elle commence par sk_live_).

Fais ton premier appel en passant la clé dans l'en-tête Authorization :

curl -H "Authorization: Bearer sk_live_xxx" \
  "https://skilzy.io/api/v1/learners?limit=100"

Tu reçois une réponse JSON : les lignes sont dans data, avec la pagination dans pagination.

{
  "resource": "learners",
  "meta": { "org_name": "Mon OF", "year": 2026, "generated_at": "..." },
  "pagination": { "limit": 100, "offset": 0, "count": 42, "total": 42, "has_more": false },
  "data": [
    { "nom": "Jean Dupont", "email": "jean@…", "temps_actif_min": 184, "evaluations_reussies": 12, … }
  ]
}

Authentification

Chaque requête doit porter une clé API d'organisme dans l'en-tête HTTP. Génère et gère tes clés depuis la page « API & intégrations » de ton dashboard.

Authorization: Bearer sk_live_xxxxxxxxxxxxxxxx

La clé n'est affichée qu'une seule fois à sa création ; copie-la immédiatement.
Une clé ne donne accès qu'aux données de ton organisation.
Tu peux révoquer une clé à tout moment ; elle renvoie alors une erreur 401.
Une clé peut avoir une date d'expiration (définie à sa création). Passé cette date, elle renvoie 401 « Clé API expirée » ; génère-en une nouvelle.
Ne partage jamais une clé côté navigateur / front-end public.

Endpoints

URL de base : https://skilzy.io/api/v1

Toutes les ressources s'interrogent en GET :

Endpoint	Contenu
GET /api/v1/learners	Synthèse par apprenant (1 ligne / apprenant)
GET /api/v1/users	Apprenants de l'org + licence associée (1 ligne / apprenant)
GET /api/v1/summary	Compteurs : apprenants + licences par type (objet unique dans data, pas un tableau)
GET /api/v1/attendance	Émargement tutorat (1 ligne / apprenant × séance)
GET /api/v1/evaluations	Tentatives de quiz (1 ligne / tentative)
GET /api/v1/quiz-answers	Réponses de quiz question par question (1 ligne / tentative × question)
GET /api/v1/documents	PIF & attestations émis (1 ligne / document)
GET /api/v1/satisfaction	Enquêtes de satisfaction (1 ligne / enquête)
GET /api/v1/enrollments	Avancement par apprenant × programme (1 ligne / inscription)
GET /api/v1/progress	Progression détaillée (1 ligne / apprenant × programme × leçon)
GET /api/v1/logins	Connexions horodatées (1 ligne / connexion)
GET /api/v1/tutoring-ratings	Notes de tutorat (séance + formateur) (1 ligne / note)
GET /api/v1/lesson-ratings	Notes de leçon milestone / fin de module (1 ligne / note)

Paramètres de requête

Paramètre	Description	Défaut
format	Format de sortie : json ou csv	json
year	Année civile filtrée (ex. 2026)	Année en cours
limit	Nombre de lignes par page (max 1000, JSON)	100
offset	Décalage de pagination (JSON)	0
updated_since	Ne renvoie que les lignes dont la date ≥ valeur (YYYY-MM-DD). Sync incrémentale. Ignoré pour learners.	—
email	Restreint à UN apprenant (email exact, insensible à la casse). 404 si inconnu dans ton organisation.	—
user_id	Comme email, mais par identifiant technique de l'apprenant.	—
programme	Restreint à UNE formation (slug de programme, ex. marketing-contenus-rs7439). Ignoré sur les ressources sans programme (learners, logins).	—

Les requêtes mono-apprenant (email ou user_id) sont servies par un chemin direct : elles ne sont pas concernées par le plafond d'agrégation org-wide (meta.truncated) et renvoient un bloc meta.learner.

# Un seul apprenant (toutes les ressources acceptent ?email= ou ?user_id=)
curl -H "Authorization: Bearer sk_live_xxx" \
  "https://skilzy.io/api/v1/learners?email=jean@orga.fr"

# Son avancement sur UNE formation (première/dernière connexion incluses)
curl -H "Authorization: Bearer sk_live_xxx" \
  "https://skilzy.io/api/v1/enrollments?email=jean@orga.fr&programme=marketing-contenus-rs7439"

# Ses réponses de quiz, question par question
curl -H "Authorization: Bearer sk_live_xxx" \
  "https://skilzy.io/api/v1/quiz-answers?email=jean@orga.fr"

Format de réponse

Les réponses JSON contiennent les métadonnées, la pagination et les lignes dans data :

{
  "resource": "learners",
  "meta": { "org_name": "Mon OF", "year": 2026, "generated_at": "..." },
  "pagination": { "limit": 100, "offset": 0, "count": 42, "total": 42, "has_more": false },
  "data": [
    { "nom": "Jean Dupont", "email": "jean@…", "temps_actif_min": 184, "evaluations_reussies": 12, … }
  ]
}

Avec ?format=csv, la réponse est un fichier CSV (UTF-8 avec BOM, séparateur virgule) téléchargeable, sans pagination.

Exception : la ressource summary renvoie un objet unique dans data (pas un tableau) et n'a pas de pagination :

{
  "resource": "summary",
  "meta": { "org_name": "Mon OF", "generated_at": "2026-06-10T09:00:00.000Z" },
  "data": {
    "utilisateurs": { "total": 38, "actifs": 31 },
    "licences": {
      "standard": { "total": 50, "disponibles": 12, "utilisees": 38 },
      "tutorat":  { "total": 10, "disponibles": 4,  "utilisees": 6 }
    }
  }
}

Référence des champs

Les clés JSON sont identiques en français quelle que soit la langue. Les valeurs booléennes sont renvoyées « Oui » / « Non ».