> ## 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. # Vérifications du jour par heure : API Didit > Didit : vérifications du jour par heure locale, comparées à la semaine passée, par statut (approuvées, en examen, refusées). Prompt API : vérifications du jour par heure Copier le prompt dans le presse-papiers \

\`Read today's verifications of my Didit application hour by hour.

Endpoint:
GET https://verification.didit.me/v3/organization/{organization_id}/application/{application_id}/analytics/today/

Authentication:
Use the x-api-key header with my Didit API key. Only a full-access key works: any scoped key gets 403 "This API key has no access to this endpoint.". application_id must be the application the key belongs to.

Goal:
\- Show today's verification volume by hour against the same weekday last week, and today's outcomes, in my own dashboard.

Query parameters:
\- tz - IANA time zone whose midnight starts today, for example Europe/Madrid. Omit it for UTC.

Behavior:
\- hours - 24 counts: today's user verification (KYC) sessions by the local hour they were created in. The hours still to come are 0.
\- previous_hours - the same 24 counts for previous_date, the same weekday one week before.
\- total - today's verifications so far. previous_total_so_far - the comparison day's up to the same local time, so (total - previous_total_so_far) / previous_total_so_far compares the same part of both days.
\- outcomes - of today's verifications, how many are approved, in review and declined now. The rest are not finished yet.
\- current_hour - the local hour it is now. A day on which the clocks change has 23 or 25 hours: the missing hour stays 0 and the repeated hour holds both.

Example call:
curl -X GET "https://verification.didit.me/v3/organization/11111111-2222-3333-4444-555555555555/application/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee/analytics/today/?tz=Europe%2FMadrid" \
-H "x-api-key: YOUR_API_KEY"

Failure modes:
\- 400 - {"tz": ["Unknown time zone: Europe/Atlantis."]} for a name the time zone database does not know.
\- 401 - the API key has expired.
\- 403 - missing or invalid key ({"detail": "Authentication credentials were not provided or are invalid."}), a key of another application ({"detail": "You do not have permission to perform this action."}), any scoped key, or a request from outside the key's IP list.
\- 429 - more than 600 GET requests per minute with this key.

Side effects: none. Not billed.

For the full integration shape, see /integration/integration-prompt.`

\
Coller dans L’API des vérifications du jour par heure de Didit renvoie les vérifications des utilisateurs de la journée, heure par heure, à partir de minuit dans le fuseau horaire que vous envoyez. Elle les présente à côté des mêmes heures du même jour de la semaine, la semaine précédente. Ce sont les données qui alimentent la carte de volume de l’accueil de la Business Console.| Champ | Contenu | | - | - | | `hours` | Les vérifications de la journée par heure locale, à partir de 00:00. Les heures à venir valent `0`. | | `previous_hours` | Les mêmes heures à la date `previous_date`, c’est-à-dire le même jour de la semaine, une semaine plus tôt. | | `total`, `previous_total_so_far` | Le total du jour à ce moment, et celui du jour de comparaison jusqu’à la même heure locale. | | `outcomes` | Parmi les vérifications du jour, le nombre de vérifications actuellement `approved`, `in_review` et `declined`. |Les chiffres sont lus en direct à partir de vos vérifications : une vérification créée il y a un instant est donc déjà comptée. Pour une plage de dates et les autres indicateurs du tableau de bord, utilisez [Get Application Analytics](https://docs.didit.me/fr/management-api/analytics/get.md).> [!NOTE] > > Seule une clé API à accès complet peut appeler cet endpoint. Une clé à accès restreint reçoit un `403` quel que soit son niveau d’accès, et il en va de même pour une clé appartenant à une autre application. Voir [Clés API](https://docs.didit.me/fr/console/api-keys.md).## Ressources associées- [Get Application Analytics](https://docs.didit.me/fr/management-api/analytics/get.md) - [Tableau de bord analytique](https://docs.didit.me/fr/console/analytics.md) - [Clés API et accès restreints](https://docs.didit.me/fr/console/api-keys.md) ## OpenAPI ````yaml fr/openapi-25.json GET /v3/organization/{organization_id}/application/{application_id}/analytics/today/ 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/organization/{organization_id}/application/{application_id}/analytics/today/: get: tags: - Analytics summary: Obtenir les vérifications du jour par heure description: >- Sessions de vérification des utilisateurs (KYC) d'aujourd'hui, à partir de minuit heure locale dans `tz`, comptabilisées par heure locale de création, aux côtés des mêmes heures du même jour de la semaine une semaine auparavant, et réparties selon le résultat actuel : approuvé, en cours d'examen ou refusé. Il s'agit de la carte de volume de l'écran d'accueil de la Business Console. `total` correspond à aujourd'hui jusqu'à présent. `previous_total_so_far` comptabilise le jour de comparaison uniquement jusqu'à la même heure locale, de sorte qu'une variation entre les deux compare la même partie des deux journées. Les heures restant à venir aujourd'hui valent `0`. Un jour de changement d'heure compte 23 ou 25 heures : l'heure manquante reste à `0` et l'heure répétée cumule les deux. operationId: get_application_analytics_today parameters: - name: organization_id in: path required: true schema: type: string format: uuid description: UUID de l'organisation. example: 11111111-2222-3333-4444-555555555555 - name: application_id in: path required: true schema: type: string format: uuid description: >- UUID de l'application. Doit être l'application à laquelle appartient la clé API : une clé utilisée sur toute autre application reçoit une erreur `403`. example: aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee - name: tz in: query required: false schema: type: string default: UTC example: Europe/Madrid description: >- Fuseau horaire IANA dont minuit marque le début d'aujourd'hui, par exemple `Europe/Madrid` ou `America/Mexico_City`. Omettez-le pour UTC. responses: '200': description: >- Vérifications d'aujourd'hui par heure locale, celles du jour de comparaison et les résultats d'aujourd'hui. content: application/json: schema: $ref: '#/components/schemas/ApplicationAnalyticsToday' examples: Madrid, 14:00: value: time_zone: Europe/Madrid date: '2026-10-30' current_hour: 14 previous_date: '2026-10-23' hours: - 3 - 1 - 0 - 0 - 1 - 2 - 4 - 9 - 14 - 18 - 21 - 19 - 22 - 24 - 27 - 0 - 0 - 0 - 0 - 0 - 0 - 0 - 0 - 0 previous_hours: - 2 - 1 - 1 - 0 - 1 - 3 - 5 - 8 - 12 - 16 - 19 - 18 - 20 - 22 - 24 - 26 - 23 - 19 - 15 - 12 - 9 - 7 - 5 - 3 total: 165 previous_total_so_far: 151 outcomes: approved: 139 in_review: 6 declined: 18 '400': description: >- Fuseau horaire inconnu. Le corps est indexé par le paramètre, avec une liste de messages. content: application/json: schema: type: object additionalProperties: type: array items: type: string examples: Unknown time zone: value: tz: - 'Unknown time zone: Europe/Atlantis.' '401': description: >- La clé API a expiré. Seule une clé créée avec une date d'expiration peut expirer ; après cette date, chaque requête effectuée avec celle-ci renvoie `401`. content: application/json: schema: type: object properties: detail: type: string examples: Expired key: value: detail: This API key has expired. '403': description: "La requête n'est pas autorisée. Consultez `detail`\_: une clé API manquante ou invalide (jamais `401`), une clé d'une autre application, toute clé avec restriction de portée, ou une requête provenant de l'extérieur de la liste d'adresses IP de la clé." content: application/json: schema: type: object properties: detail: type: string examples: Missing or invalid key: value: detail: >- Authentication credentials were not provided or are invalid. Another application: value: detail: You do not have permission to perform this action. Scoped key: value: detail: This API key has no access to this endpoint. Outside the key's IP list: value: detail: This API key can't be used from this IP address. '429': description: >- Plus de 600 requêtes GET par minute avec cette clé API. Attendez le nombre de secondes indiqué dans `Retry-After`, puis réessayez. content: application/json: schema: type: object properties: detail: type: string examples: Throttled: value: detail: >- GET request rate limit exceeded. You can make up to 600 requests per minute. headers: Retry-After: description: >- Secondes avant la réinitialisation de la fenêtre actuelle d'une minute. schema: type: integer example: 23 X-RateLimit-Limit: description: Requêtes autorisées par minute dans ce budget. schema: type: integer X-RateLimit-Remaining: description: Requêtes restantes dans la fenêtre actuelle. schema: type: integer X-RateLimit-Reset: description: Temps Unix auquel la fenêtre se réinitialise. schema: type: integer security: - ApiKeyAuth: [] x-codeSamples: - lang: curl label: curl source: >- curl -X GET 'https://verification.didit.me/v3/organization/11111111-2222-3333-4444-555555555555/application/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee/analytics/today/?tz=Europe%2FMadrid' \ -H 'x-api-key: YOUR_API_KEY' components: schemas: ApplicationAnalyticsToday: type: object description: >- Vérifications d'aujourd'hui par heure locale par rapport au même jour de la semaine la semaine dernière. required: - time_zone - date - current_hour - previous_date - hours - previous_hours - total - previous_total_so_far - outcomes properties: time_zone: type: string description: Le fuseau horaire IANA auquel correspondent le jour et ses heures. example: Europe/Madrid date: type: string format: date description: Aujourd'hui dans ce fuseau horaire. example: '2026-10-30' current_hour: type: integer minimum: 0 maximum: 23 description: L'heure locale actuelle. example: 14 previous_date: type: string format: date description: >- Le jour de comparaison : le même jour de la semaine une semaine plus tôt. example: '2026-10-23' hours: type: array items: type: integer minimum: 0 minItems: 24 maxItems: 24 description: >- Vérifications créées aujourd'hui, par heure locale à partir de 00:00. Les heures à venir indiquent 0. previous_hours: type: array items: type: integer minimum: 0 minItems: 24 maxItems: 24 description: >- Vérifications créées le jour de comparaison, par heure locale à partir de 00:00. total: type: integer minimum: 0 description: Vérifications créées aujourd'hui jusqu'à présent. example: 165 previous_total_so_far: type: integer minimum: 0 description: >- Vérifications créées le jour de comparaison jusqu'à la même heure locale. example: 151 outcomes: type: object description: >- Parmi les vérifications d'aujourd'hui, combien sont actuellement approuvées, en attente d'examen et refusées. Les autres ne sont pas encore terminées. required: - approved - in_review - declined properties: approved: type: integer minimum: 0 in_review: type: integer minimum: 0 declined: type: integer minimum: 0 securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- La clé API de votre application, issue de Développeurs -> Clés API dans la Business Console. La clé principale dispose d'un accès complet. Une clé nommée peut être restreinte : aucun, lecture ou écriture par ressource, limitée à certains workflows ou aux sessions approuvées, à une liste d'adresses IP et à une date d'expiration. 401 signifie que la clé est incorrecte, révoquée ou expirée ; 403 signifie qu'aucune clé n'a été envoyée, que la clé n'a pas accès à cette ressource ou action, ou que la requête provient d'une adresse hors de sa liste d'IP ; 404 sur une route de session signifie que la session est hors des workflows ou des statuts de la clé. Une clé sans accès aux médias reçoit les URL d'images, de vidéos et de PDF à null, et une clé sans accès en écriture aux sessions reçoit les liens et tokens de session à null. Voir https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.