API CaptchEtat
The CaptchEtat API generates CAPTCHA challenges based on a distorted character string that users must reproduce. It is intended for interministerial partners and public-sector entities seeking to secure online forms and services against automated access. The API returns the elements needed to display and verify a challenge, including HTML structure, images, audio files, and the corresponding character string. It is maintained by the French government and forms part of the shared technical services offered to public administrations for identity and access protection on their digital platforms.L’API CaptchEtat permet de générer un CAPTCHA de type de chaine de caractères déformée à reproduire. Elle est destinée aux partenaires interministériels ou à des entités publiques. ## Contenu accessible via cette API Elle contient les données suivantes : - structure HTML - images - sons - chaîne…
Trust score
How is this computed?Weighted across five axes. Tap a ring for what it measures.
Data schema (8 fields)
| Field | Type | Description |
|---|---|---|
| get | string | Type of object to retrieve (e.g. HTML, image, sound).Type d'objet voulant être récupéré. |
| c | string | Name of the captcha to retrieve, required for image or sound requests.Nom du captcha voulant être récupéré. Ce parametre est obligatoire lorsqu'on choisi les types d'objets du parametre get suivants (image, sound) |
| t | string | Technical captcha identifier, auto-filled when fetching the matching audio.Identifiant captcha, c'est un parametre technique non utilisable par le developpeur. Il est renseigné automatiquement par l'appel avec get=sound, pour récupérer le captcha audio correspondant à l'image affichée. |
| uuid | string | Unique identifier of the captcha.Identifiant du captcha |
| statusresultHealthcheck | string | Health status result of the service check.Health status result of the service check. |
| componentsresultHealthcheck | object | Detailed status of the individual components checked.Detailed status of the individual components checked. |
| imageb64resultCaptcha | string | Captcha image encoded in Base64 format.Captcha image encoded in Base64 format. |
| codevaliderCaptcha | string | Captcha code entered by the user for validation.Code du captcha à valider |
Schema captured from openapi 26 days ago.
Verification Status
Using the API
Configuration
- Base URL
- https://sandbox-api.piste.gouv.fr/piste/captchetat/v2
- Format
- openapi
Query examples
Stored only in this browser. Runs go directly from your browser to the API — the key is never sent through our servers.
curl -s 'https://raw.githubusercontent.com/betagouv/api_gouv_swaggers/main/swaggers/api-captchetat.json' -H 'Accept: application/json'Machine-readable API description (use it to generate clients).
Machine-readable & source
Embed this badge in a README or wiki — it always shows the latest verification state and quality tier.