Référence

Statut du service

L’état de la plateforme est public sur status.getsms.tech. Les mêmes données sont lisibles par l’API, sans clé : pour afficher un bandeau dans votre application, mettre en pause vos envois pendant une panne ou alimenter votre propre supervision.

État des services

GET/v1/statussans clé · mis en cache 30 s

Renvoie l’état de chaque service, 90 jours d’historique, les indicateurs des dernières 24 heures et les incidents. Chaque service est vérifié toutes les minutes.

statusstring

État général : le pire des états des services. operational, maintenance, degraded, partial_outage ou major_outage.

checked_atdate ISO 8601

Heure de la dernière vérification.

componentstableau

Un élément par service : id (api, sending, receiving, webhooks, dashboard, payments, docs), status, uptime_90d (disponibilité sur 90 jours, en pourcentage) et days, l’historique jour par jour (date, status, downtime_minutes). Un jour sans mesure vaut no_data.

metricsobjet

api_p95_ms (temps de réponse de l’API, 95ᵉ centile), send_delay_median_s (délai médian entre l’acceptation et l’envoi), delivery_rate_24h (taux de livraison en pourcentage), et series : les mêmes valeurs heure par heure sur 24 heures, de la plus ancienne à la plus récente. null quand il n’y a pas de données.

incidentsobjet

active (en cours), scheduled (maintenances prévues) et recent (90 derniers jours). Chaque incident a un titre en français et en anglais (title, title_en), un type (incident ou maintenance), un impact (minor, major, critical ou maintenance), les services touchés et ses mises à jour (updates).

curl https://api.getsms.tech/v1/status

const res = await fetch("https://api.getsms.tech/v1/status");
const { data } = await res.json();
if (data.status !== "operational") console.warn("GetSMS :", data.status);

import requests

data = requests.get("https://api.getsms.tech/v1/status").json()["data"]
if data["status"] != "operational":
    print("GetSMS :", data["status"])

<?php
$data = json_decode(file_get_contents("https://api.getsms.tech/v1/status"), true)["data"];
if ($data["status"] !== "operational") {
    error_log("GetSMS : " . $data["status"]);
}

{
  "status": "success",
  "message": "état des services",
  "data": {
    "status": "operational",
    "checked_at": "2026-11-11T09:42:00Z",
    "components": [
      {
        "id": "sending",
        "status": "operational",
        "uptime_90d": 99.98,
        "days": [{ "date": "2026-11-11", "status": "operational", "downtime_minutes": 0 }]
      }
    ],
    "metrics": {
      "api_p95_ms": 84,
      "send_delay_median_s": 3.2,
      "delivery_rate_24h": 98.7,
      "series": { "api_p95_ms": [], "send_delay_median_s": [], "delivery_rate": [] }
    },
    "incidents": { "active": [], "scheduled": [], "recent": [] }
  }
}

Les états, du meilleur au pire :

État	Signification
`operational`	Le service fonctionne normalement.
`maintenance`	Une maintenance prévue est en cours.
`degraded`	Le service fonctionne mais plus lentement.
`partial_outage`	Une partie des requêtes échoue.
`major_outage`	Le service est indisponible.

Flux RSS

GET/v1/status/feed.xmlsans clé · RSS 2.0

Les incidents et maintenances des 90 derniers jours, avec leurs mises à jour. Ajoutez ?lang=en pour le flux en anglais. Le flux se branche sur un lecteur RSS ou sur un canal Slack ou Teams.

Alertes par e-mail

POST/v1/status/subscribesans clé · double opt-in

Inscrit une adresse aux e-mails d’incident et de maintenance. Un lien de confirmation, valable 48 heures, est envoyé à l’adresse : rien n’est envoyé tant qu’il n’est pas ouvert. Le formulaire de status.getsms.tech appelle cette route.

emailstringrequis

L’adresse à inscrire.

langstring

fr (par défaut) ou en : langue des e-mails.

{
  "status": "success",
  "message": "si cette adresse peut recevoir nos e-mails, un lien de confirmation vient d’y être envoyé"
}

{
  "status": "error",
  "message": "trop de demandes, réessayez dans une heure"
}

La réponse est la même que l’adresse soit nouvelle, en attente ou déjà inscrite : elle ne révèle pas qui est abonné. Une même adresse IP peut faire 5 inscriptions par heure.

Les liens des e-mails mènent à deux routes, qui renvoient ensuite vers la page de statut :

GET /v1/status/subscriptions/confirm?token=… confirme l’inscription (?subscribed=1, ou ?subscribed=0 si le lien a expiré).
GET /v1/status/subscriptions/unsubscribe?token=… désinscrit l’adresse (?unsubscribed=1). Chaque e-mail contient ce lien.