> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# API de statut des services Didit : flux public d'état

> GET /v3/status/ : flux public sans authentification de l'état des services Didit et de 7 jours d'incidents, pour widgets de statut.



Prompt d'état du service
        Copier le prompt dans le presse-papiers



      
      

\<pre>

\`Read Didit's public service status feed.

GET https://verification.didit.me/v3/status/

Auth: NONE. Send no auth header.

Success (HTTP 200):
\- status: worst state of any service right now: "operational" | "degraded" | "down"
\- updated_at: ISO 8601 time Didit built the response (up to 30 seconds old)
\- services[]: one { key, name, status } per service. Match on key, never on name. Keys:
service_id_verification, service_liveness_face_match, service_aml_screening, service_kyb_registries,
service_database_validation, service_phone_delivery, service_email_delivery, service_transaction_monitoring
\- incidents[]: newest started_at first. Every ongoing incident plus those resolved in the last 7 days (at most 50 resolved). Each:
\{ id, service, service_name, state ("degraded" | "down"), status ("ongoing" | "resolved"), title, body,
affected, country_name, started_at, resolved_at (null while ongoing), duration_minutes (null while ongoing) }
\- title and body are English. To translate, build your own text from service, state and country_name.

Cadence: responses are cached for 30 seconds. Poll no more than once every 30 seconds.

curl -fsS https://verification.didit.me/v3/status/

For end-to-end Didit integration, paste in the full prompt at /integration/integration-prompt.`

\</pre>



      
      

Coller dans

## Vue d'ensembleRenvoie l'état de chaque service Didit, l'état global et les incidents en cours ou résolus au cours des 7 derniers jours.
L'endpoint est public : n'envoyez aucun en-tête d'authentification.
La réponse ne contient aucune donnée d'organisation et est identique pour tous les appelants.## Quand l'utiliser- **Widget d'état** : affichez à vos utilisateurs ou à votre équipe support si un service Didit est dégradé en ce moment.
- **Contrôle de santé de l'intégration** : avant d'incriminer votre propre code pour des vérifications lentes ou en échec, vérifiez si Didit signale un incident sur le service que vous appelez.
- **Historique des incidents** : listez ce qui s'est passé au cours des 7 derniers jours et la durée de chaque incident.Pour vérifier uniquement que l'API est joignable, utilisez plutôt le [contrôle d'état](https://docs.didit.me/fr/api-reference/healthcheck.md).## InterrogationLes réponses sont mises en cache pendant 30 secondes : n'interrogez donc pas l'endpoint plus d'une fois toutes les 30 secondes.
`updated_at` indique à quel moment Didit a généré la réponse que vous avez reçue.
Une limite de 600 requêtes GET par minute et par adresse IP s'applique également.## Services`services` liste chaque service, qu'il ait ou non un incident.
Faites la correspondance sur `key` : `name` est un nom d'affichage en anglais et peut changer.| `key` | Service |
| - | - |
| `service_id_verification` | Vérification d'identité |
| `service_liveness_face_match` | Détection du vivant et correspondance faciale |
| `service_aml_screening` | Filtrage AML |
| `service_kyb_registries` | Registres KYB |
| `service_database_validation` | Validation en base de données |
| `service_phone_delivery` | Livraison de la vérification du téléphone |
| `service_email_delivery` | Livraison de la vérification de l'e-mail |
| `service_transaction_monitoring` | Surveillance des transactions |Le `status` de chaque service est `operational`, `degraded` ou `down`.
Il vaut `operational` lorsque le service n'a aucun incident en cours. Sinon, il correspond à l'état le plus grave parmi ses incidents en cours.
Le `status` de niveau supérieur correspond à l'état le plus grave de l'ensemble des services.## Incidents`incidents` liste chaque incident en cours ainsi que les incidents résolus au cours des 7 derniers jours, du plus récent `started_at` au plus ancien.
50 incidents résolus au maximum sont listés.- `state` vaut `degraded` ou `down`. Un incident résolu conserve le dernier état qu'il avait.
- `status` vaut `ongoing` tant que le service ne s'est pas rétabli, puis `resolved`.
- `resolved_at` et `duration_minutes` valent `null` tant que l'incident est en cours.
- `affected` et `country_name` désignent le pays ou le registre concerné, par exemple `Brazil (CPF)` et `Brazil`. Ils sont vides lorsque l'incident n'est pas lié à un pays ou à un registre.
- `title` et `body` sont en anglais. Pour afficher l'incident dans une autre langue, composez votre propre texte à partir de `service`, `state` et `country_name`.## Exemple de réponse```json theme={null}
{
  "status": "degraded",
  "updated_at": "2026-10-13T09:41:07.512345Z",
  "services": [
    { "key": "service_id_verification", "name": "ID verification", "status": "operational" },
    { "key": "service_liveness_face_match", "name": "Liveness and face match", "status": "operational" },
    { "key": "service_aml_screening", "name": "AML screening", "status": "operational" },
    { "key": "service_kyb_registries", "name": "KYB registries", "status": "operational" },
    { "key": "service_database_validation", "name": "Database validation", "status": "degraded" },
    { "key": "service_phone_delivery", "name": "Phone verification delivery", "status": "operational" },
    { "key": "service_email_delivery", "name": "Email verification delivery", "status": "operational" },
    { "key": "service_transaction_monitoring", "name": "Transaction monitoring", "status": "operational" }
  ],
  "incidents": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "service": "service_database_validation",
      "service_name": "Database validation",
      "state": "degraded",
      "status": "ongoing",
      "title": "Database validation is degraded in Brazil.",
      "body": "Checks against Brazil (CPF) may be slow or fail since 08:55 UTC.",
      "affected": "Brazil (CPF)",
      "country_name": "Brazil",
      "started_at": "2026-10-13T08:55:00Z",
      "resolved_at": null,
      "duration_minutes": null
    },
    {
      "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "service": "service_aml_screening",
      "service_name": "AML screening",
      "state": "down",
      "status": "resolved",
      "title": "AML screening is back to normal.",
      "body": "Recovered at 14:32 UTC after 17 minutes.",
      "affected": "",
      "country_name": "",
      "started_at": "2026-10-11T14:15:00Z",
      "resolved_at": "2026-10-11T14:32:00Z",
      "duration_minutes": 17
    }
  ]
}
```## Voir aussi- [Contrôle d'état](https://docs.didit.me/fr/api-reference/healthcheck.md) : une sonde de disponibilité publique, qui ne nécessite elle aussi aucun en-tête d'authentification.
- [Webhooks d'alerte](https://docs.didit.me/fr/integration/alert-webhooks.md) : recevez `alert.service.degraded` et `alert.service.recovered` sur votre endpoint, pour les services utilisés par votre organisation.
- [Limitation de débit](https://docs.didit.me/fr/integration/rate-limiting.md)


## OpenAPI

````yaml fr/openapi-25.json GET /v3/status/
openapi: 3.0.0
info:
  version: 3.0.0
  title: Didit Verification API
  description: API de vérification d'identité. Authentifiez-vous avec l'en-tête x-api-key.
servers:
  - url: https://verification.didit.me
security: []
tags: []
paths:
  /v3/status/:
    get:
      tags:
        - Status
      summary: Obtenir l'état du service (public, non authentifié)
      description: >-
        Renvoie l'état de chaque service Didit (`operational`, `degraded` ou
        `down`), l'état global (le pire d'entre eux) et les incidents en cours
        ou résolus au cours des 7 derniers jours. Utilisez-le pour alimenter un
        widget de statut ou pour vérifier l'état de Didit depuis votre
        intégration.


        Public : n'envoyez aucun en-tête d'authentification. La réponse ne
        contient aucune donnée d'organisation et est identique pour chaque
        appelant. Les réponses sont mises en cache pendant 30 secondes,
        n'effectuez donc pas d'appels plus d'une fois toutes les 30 secondes.
      operationId: get_v3_status
      parameters: []
      responses:
        '200':
          description: État actuel du service.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceStatusFeed'
              examples:
                One service degraded:
                  summary: Un incident en cours et un incident résolu cette semaine
                  value:
                    status: degraded
                    updated_at: '2026-10-13T09:41:07.512345Z'
                    services:
                      - key: service_id_verification
                        name: ID verification
                        status: operational
                      - key: service_liveness_face_match
                        name: Liveness and face match
                        status: operational
                      - key: service_aml_screening
                        name: AML screening
                        status: operational
                      - key: service_kyb_registries
                        name: KYB registries
                        status: operational
                      - key: service_database_validation
                        name: Database validation
                        status: degraded
                      - key: service_phone_delivery
                        name: Phone verification delivery
                        status: operational
                      - key: service_email_delivery
                        name: Email verification delivery
                        status: operational
                      - key: service_transaction_monitoring
                        name: Transaction monitoring
                        status: operational
                    incidents:
                      - id: 3fa85f64-5717-4562-b3fc-2c963f66afa6
                        service: service_database_validation
                        service_name: Database validation
                        state: degraded
                        status: ongoing
                        title: Database validation is degraded in Brazil.
                        body: >-
                          Checks against Brazil (CPF) may be slow or fail since
                          08:55 UTC.
                        affected: Brazil (CPF)
                        country_name: Brazil
                        started_at: '2026-10-13T08:55:00Z'
                        resolved_at: null
                        duration_minutes: null
                      - id: 7c9e6679-7425-40de-944b-e07fc1f90ae7
                        service: service_aml_screening
                        service_name: AML screening
                        state: down
                        status: resolved
                        title: AML screening is back to normal.
                        body: Recovered at 14:32 UTC after 17 minutes.
                        affected: ''
                        country_name: ''
                        started_at: '2026-10-11T14:15:00Z'
                        resolved_at: '2026-10-11T14:32:00Z'
                        duration_minutes: 17
                All operational:
                  summary: Aucun incident au cours des 7 derniers jours
                  value:
                    status: operational
                    updated_at: '2026-10-13T09:41:07.512345Z'
                    services:
                      - key: service_id_verification
                        name: ID verification
                        status: operational
                      - key: service_liveness_face_match
                        name: Liveness and face match
                        status: operational
                      - key: service_aml_screening
                        name: AML screening
                        status: operational
                      - key: service_kyb_registries
                        name: KYB registries
                        status: operational
                      - key: service_database_validation
                        name: Database validation
                        status: operational
                      - key: service_phone_delivery
                        name: Phone verification delivery
                        status: operational
                      - key: service_email_delivery
                        name: Email verification delivery
                        status: operational
                      - key: service_transaction_monitoring
                        name: Transaction monitoring
                        status: operational
                    incidents: []
        '429':
          description: >-
            Plus de 600 requêtes GET en une minute depuis la même adresse IP (ou
            la même clé API, si vous en envoyez une). Respectez `Retry-After`
            avant de réessayer.
          content:
            application/json:
              schema:
                type: object
                required:
                  - detail
                properties:
                  detail:
                    type: string
              example:
                detail: >-
                  GET request rate limit exceeded. You can make up to 600
                  requests per minute.
      security:
        - {}
      x-codeSamples:
        - lang: curl
          label: curl
          source: curl -fsS https://verification.didit.me/v3/status/
        - lang: python
          label: Python
          source: >-
            import requests


            resp = requests.get('https://verification.didit.me/v3/status/',
            timeout=5)

            resp.raise_for_status()

            feed = resp.json()

            print(feed['status'])

            for service in feed['services']:
                if service['status'] != 'operational':
                    print(service['key'], service['status'])
        - lang: javascript
          label: JavaScript
          source: >-
            const feed = await
            fetch('https://verification.didit.me/v3/status/').then((r) =>
            r.json());

            console.log(feed.status);

            const affected = feed.services.filter((s) => s.status !==
            'operational');

            console.log(affected.map((s) => `${s.key}: ${s.status}`));
components:
  schemas:
    ServiceStatusFeed:
      type: object
      description: >-
        État public des services : l'état de chaque service Didit, l'état global
        et les incidents en cours ou résolus au cours des 7 derniers jours.
      required:
        - status
        - updated_at
        - services
        - incidents
      properties:
        status:
          type: string
          enum:
            - operational
            - degraded
            - down
          description: >-
            Le pire état parmi tous les services en ce moment, déterminé
            uniquement par les incidents en cours.
          example: degraded
        updated_at:
          type: string
          format: date-time
          description: >-
            Date et heure auxquelles Didit a généré cette réponse (ISO 8601,
            UTC). Les réponses sont mises en cache pendant 30 secondes, elles
            peuvent donc dater de 30 secondes maximum.
          example: '2026-10-13T09:41:07.512345Z'
        services:
          type: array
          description: Une entrée par service, chaque service étant toujours répertorié.
          items:
            $ref: '#/components/schemas/ServiceStatusService'
        incidents:
          type: array
          description: >-
            Du `started_at` le plus récent au plus ancien. Tous les incidents en
            cours, ainsi que les incidents résolus au cours des 7 derniers jours
            (au maximum 50 incidents résolus). Vide si rien ne s'est produit
            pendant cette période.
          items:
            $ref: '#/components/schemas/ServiceStatusIncident'
    ServiceStatusService:
      type: object
      required:
        - key
        - name
        - status
      properties:
        key:
          type: string
          enum:
            - service_id_verification
            - service_liveness_face_match
            - service_aml_screening
            - service_kyb_registries
            - service_database_validation
            - service_phone_delivery
            - service_email_delivery
            - service_transaction_monitoring
          description: >-
            Clé de service stable. Effectuez vos correspondances sur cette
            valeur, jamais sur le nom affiché. `service_id_verification` :
            Vérification d'identité, `service_liveness_face_match` : Détection
            du vivant et correspondance faciale, `service_aml_screening` :
            Filtrage AML, `service_kyb_registries` : registres KYB,
            `service_database_validation` : Validation en base de données,
            `service_phone_delivery` : Livraison de la vérification du
            téléphone, `service_email_delivery` : Livraison de la vérification
            de l'e-mail, `service_transaction_monitoring` : Surveillance des
            transactions.
          example: service_database_validation
        name:
          type: string
          description: Nom d'affichage en anglais du service.
          example: Database validation
        status:
          type: string
          enum:
            - operational
            - degraded
            - down
          description: >-
            `operational` lorsqu'aucun incident n'est en cours pour le service,
            sinon l'état le plus critique de ses incidents en cours.
          example: degraded
    ServiceStatusIncident:
      type: object
      required:
        - id
        - service
        - service_name
        - state
        - status
        - title
        - body
        - affected
        - country_name
        - started_at
        - resolved_at
        - duration_minutes
      properties:
        id:
          type: string
          format: uuid
          description: Identifiant de l'incident.
          example: 3fa85f64-5717-4562-b3fc-2c963f66afa6
        service:
          type: string
          enum:
            - service_id_verification
            - service_liveness_face_match
            - service_aml_screening
            - service_kyb_registries
            - service_database_validation
            - service_phone_delivery
            - service_email_delivery
            - service_transaction_monitoring
          description: Clé du service concerné (voir `services[].key`).
          example: service_database_validation
        service_name:
          type: string
          description: Nom d'affichage en anglais du service concerné.
          example: Database validation
        state:
          type: string
          enum:
            - degraded
            - down
          description: >-
            Comment le service est affecté. Un incident résolu conserve le
            dernier état qu'il avait.
          example: degraded
        status:
          type: string
          enum:
            - ongoing
            - resolved
          description: '`ongoing` jusqu''à ce que le service soit rétabli, puis `resolved`.'
          example: ongoing
        title:
          type: string
          description: >-
            Titre en anglais. Pour le traduire, construisez votre propre texte à
            partir de `service`, `state` et `country_name`.
          example: Database validation is degraded in Brazil.
        body:
          type: string
          description: >-
            Ligne de détail en anglais : depuis quand les vérifications peuvent
            être lentes ou échouer, ou quand le service s'est rétabli.
          example: Checks against Brazil (CPF) may be slow or fail since 08:55 UTC.
        affected:
          type: string
          description: >-
            Pays ou registres concernés, par exemple `Brazil (CPF)`. Vide
            lorsque l'incident n'est pas lié à un pays ou à un registre.
          example: Brazil (CPF)
        country_name:
          type: string
          description: >-
            Pays concerné, en anglais. Vide lorsque l'incident n'est pas lié à
            un pays.
          example: Brazil
        started_at:
          type: string
          format: date-time
          description: Moment où l'incident a commencé (ISO 8601, UTC).
          example: '2026-10-13T08:55:00Z'
        resolved_at:
          type: string
          format: date-time
          nullable: true
          description: >-
            Moment où le service s'est rétabli (ISO 8601, UTC). `null` tant que
            l'incident est en cours.
        duration_minutes:
          type: integer
          nullable: true
          description: >-
            Minutes entières écoulées entre `started_at` et `resolved_at`.
            `null` tant que l'incident est en cours.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.