SSquadra
Plan Pro et Enterprise

Branchez Squadra à vos outils

Notre API vous permet de récupérer vos données (planning, pointages, employés, congés) depuis n'importe quel outil externe : Power BI, Metabase, SIRH, script Excel, dashboard interne... sans aucun code à écrire côté Squadra.

Générer une clé APISpec OpenAPI

À quoi ça sert concrètement ?

Dashboard Power BI / Metabase

Créez un tableau de bord décisionnel sur vos heures de travail, coûts, absences.

Export automatique vers Excel

Script quotidien qui récupère les pointages et remplit votre fichier paie.

Sync SIRH ou CRM

Aligner les effectifs et les absences avec votre logiciel RH ou votre CRM.

Lecture seule

Aucune écriture, vos données ne peuvent pas être modifiées depuis l'API.

Accès limités

Chaque clé a ses permissions. Créez une clé par intégration, c'est plus sûr.

1000 appels / heure

Généreux quota, traçabilité complète, révocation immédiate en cas de souci.

Comment ça marche — en 3 étapes

1

Générer une clé API

Depuis votre espace Admin → Clés API, cliquez sur « Nouvelle clé ». Choisissez un nom (ex: « Dashboard Power BI ») et cochez les accès dont vous avez besoin. La clé s'affiche UNE SEULE FOIS — copiez-la tout de suite.

Générer une clé API
2

L'envoyer dans chaque requête

Dans votre outil, ajoutez la clé dans l'en-tête HTTP « Authorization » au format Bearer. C'est ce qui nous permet de reconnaître votre organisation.

Authorization: Bearer sqd_live_xxxxxxxxxxxxxxxxxxxx
3

Appeler une URL

Appelez l'adresse qui correspond à la donnée voulue (employés, pointages, shifts...). Vous recevez un JSON propre, prêt à être utilisé.

curl https://www.squadraplanning.com/api/v1/employees \
  -H "Authorization: Bearer sqd_live_..."

Que pouvez-vous récupérer ?

Voici la liste des données accessibles. Chaque URL commence par https://www.squadraplanning.com/api

GET/v1/organization

Nom et plan de votre organisation

organization.read
GET/v1/employees

Employés actifs ou inactifs, avec rôle, contrat, taux horaire

employees.read
GET/v1/locations

Vos magasins, adresse, coordonnées GPS

locations.read
GET/v1/shifts

Créneaux planifiés sur une période (horaires, employé, lieu)

shifts.read
GET/v1/timesheets

Pointages réels (entrée, sortie, anomalies)

timesheets.read
GET/v1/leave-requests

Demandes de congé (statut, dates, type)

leave_requests.read

Filtrer les résultats

Tous les endpoints qui listent des données acceptent des filtres via l'URL :

limit

Nombre de résultats (max 200, défaut 50)

offset

Sauter les N premiers résultats (pour paginer)

from

Date de début (format ISO)

to

Date de fin (format ISO)

user_id

Limiter à un employé précis

location_id

Limiter à un magasin

Un exemple complet

Vous voulez récupérer tous les pointages de Lucile pour le mois d'avril :

curl "https://www.squadraplanning.com/api/v1/timesheets?user_id=LUCILE_ID&from=2026-04-01&to=2026-04-30" \
  -H "Authorization: Bearer sqd_live_xxxxxxxxxxxx"

# Response
{
  "data": [
    {
      "id": "a1b2c3...",
      "user_id": "LUCILE_ID",
      "check_in":  "2026-04-15T09:03:00Z",
      "check_out": "2026-04-15T17:58:00Z",
      "break_duration": 45,
      "status": "VALIDATED",
      "is_late": false
    }
  ]
}

Si ça ne marche pas

401Clé absente, invalide, révoquée ou expirée
402L'API demande un plan Pro ou Enterprise (passez au plan supérieur)
403Votre clé n'a pas la permission pour cet endpoint (cochez-la dans les scopes)
429Trop d'appels (max 1000 par heure) — espacez vos requêtes
500Problème chez nous — contactez le support

Prêt à démarrer ?

30 secondes suffisent pour générer une clé et tester.

Ouvrir mon espace API
Besoin d'aide ?Notre équipe vous accompagne pour votre première intégration.