> ## 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. # Heutige Verifizierungen pro Stunde API > Didit API: heutige Benutzerverifizierungen pro Stunde in Ihrer Zeitzone, mit Vorwochenvergleich und Status genehmigt, in Prüfung, abgelehnt. Prompt für die Abfrage der heutigen Verifizierungen pro Stunde (API) Prompt in die Zwischenablage kopieren \

\`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.`

\
Einfügen in Didit's Today's Verifications by Hour API gibt die heutigen Benutzerverifizierungen pro Stunde zurück, ab Mitternacht in der Zeitzone, die Sie senden, neben denselben Stunden desselben Wochentags der Vorwoche. Es sind die Daten hinter der Volumenkarte auf der Home-Seite der Business Console.| Feld | Inhalt | | - | - | | `hours` | Heutige Verifizierungen pro lokaler Stunde, ab 00:00. Noch bevorstehende Stunden sind `0`. | | `previous_hours` | Dieselben Stunden am `previous_date`, also am gleichen Wochentag eine Woche zuvor. | | `total`, `previous_total_so_far` | Heute bisher sowie der Vergleichstag bis zur gleichen lokalen Uhrzeit. | | `outcomes` | Von den heutigen Verifizierungen, wie viele aktuell `approved`, `in_review` und `declined` sind. |Die Zählwerte werden live aus Ihren Verifizierungen gelesen, daher ist eine gerade erstellte Verifizierung bereits enthalten. Für einen Datumsbereich und die übrigen Dashboard-Kennzahlen verwenden Sie [Anwendungsanalysen abrufen](https://docs.didit.me/de/management-api/analytics/get.md).> [!NOTE] > > Nur ein API-Schlüssel mit vollem Zugriff kann diesen Endpoint aufrufen. Ein eingeschränkter Schlüssel erhält unabhängig davon, welchen Zugriff er hat, `403`, ebenso ein Schlüssel einer anderen Anwendung. Siehe [API-Schlüssel](https://docs.didit.me/de/console/api-keys.md).## Verwandte Inhalte- [Anwendungsanalysen abrufen](https://docs.didit.me/de/management-api/analytics/get.md) - [Analytics-Dashboard](https://docs.didit.me/de/console/analytics.md) - [API-Schlüssel und eingeschränkter Zugriff](https://docs.didit.me/de/console/api-keys.md) ## OpenAPI ````yaml de/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 für Ausweisverifizierung. Authentifizierung über den x-api-key-Header. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/organization/{organization_id}/application/{application_id}/analytics/today/: get: tags: - Analytics summary: Heutige Verifizierungen nach Stunde abrufen description: >- Die heutigen Benutzerverifizierungs-Sitzungen (KYC) ab lokaler Mitternacht in `tz`, gezählt pro lokaler Stunde, in der sie erstellt wurden, gegenübergestellt mit denselben Stunden desselben Wochentags eine Woche zuvor und aufgeschlüsselt nach dem aktuellen Ergebnis: genehmigt, in Prüfung oder abgelehnt. Dies ist die Volumen-Kachel auf der Startseite der Business Console. `total` ist der heutige Stand bis jetzt. `previous_total_so_far` zählt den Vergleichstag nur bis zur gleichen Ortszeit, sodass eine Veränderung denselben Teil beider Tage vergleicht. Die noch ausstehenden Stunden von heute sind `0`. Ein Tag mit Zeitumstellung hat 23 oder 25 Stunden: Die fehlende Stunde bleibt `0` und die doppelte Stunde enthält beide. operationId: get_application_analytics_today parameters: - name: organization_id in: path required: true schema: type: string format: uuid description: UUID der Organisation. example: 11111111-2222-3333-4444-555555555555 - name: application_id in: path required: true schema: type: string format: uuid description: >- Anwendungs-UUID. Muss die Anwendung sein, zu der der API-Schlüssel gehört: Ein für eine andere Anwendung verwendeter Schlüssel erhält `403`. example: aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee - name: tz in: query required: false schema: type: string default: UTC example: Europe/Madrid description: >- IANA-Zeitzone, deren Mitternacht den heutigen Tag beginnt, zum Beispiel `Europe/Madrid` oder `America/Mexico_City`. Für UTC weglassen. responses: '200': description: >- Heutige Verifizierungen nach lokaler Stunde, die des Vergleichstags und die heutigen Ergebnisse. 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: >- Unbekannte Zeitzone. Der Body ist nach dem Parameter gegliedert und enthält eine Liste von Nachrichten. 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: >- Der API-Schlüssel ist abgelaufen. Nur ein Schlüssel, der mit einem Ablaufdatum erstellt wurde, kann ablaufen; nach diesem Datum antwortet jede Anfrage damit mit `401`. content: application/json: schema: type: object properties: detail: type: string examples: Expired key: value: detail: This API key has expired. '403': description: >- Die Anfrage ist nicht zulässig. Prüfen Sie `detail`: ein fehlender oder ungültiger API-Schlüssel (niemals `401`), ein Schlüssel einer anderen Anwendung, ein beliebiger berechtigungsbeschränkter Schlüssel oder eine Anfrage von außerhalb der IP-Liste des Schlüssels. 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: >- Mehr als 600 GET-Anfragen pro Minute mit diesem API-Schlüssel. Warten Sie die Anzahl der Sekunden in `Retry-After` ab und führen Sie dann einen Wiederholungsversuch durch. 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: >- Sekunden bis zum Zurücksetzen des aktuellen Ein-Minuten-Fensters. schema: type: integer example: 23 X-RateLimit-Limit: description: Pro Minute in diesem Budget zulässige Anfragen. schema: type: integer X-RateLimit-Remaining: description: Im aktuellen Zeitfenster verbleibende Anfragen. schema: type: integer X-RateLimit-Reset: description: Unix-Zeit, zu der das Zeitfenster zurückgesetzt wird. 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: >- Heutige Verifizierungen nach lokaler Stunde im Vergleich zum selben Wochentag der Vorwoche. required: - time_zone - date - current_hour - previous_date - hours - previous_hours - total - previous_total_so_far - outcomes properties: time_zone: type: string description: Die IANA-Zeitzone, in der der Tag und seine Uhrzeiten liegen. example: Europe/Madrid date: type: string format: date description: Heute in dieser Zeitzone. example: '2026-10-30' current_hour: type: integer minimum: 0 maximum: 23 description: Die aktuelle lokale Stunde. example: 14 previous_date: type: string format: date description: 'Der Vergleichstag: derselbe Wochentag eine Woche zuvor.' example: '2026-10-23' hours: type: array items: type: integer minimum: 0 minItems: 24 maxItems: 24 description: >- Heute erstellte Verifizierungen, pro lokaler Stunde ab 00:00 Uhr. Die noch kommenden Stunden sind 0. previous_hours: type: array items: type: integer minimum: 0 minItems: 24 maxItems: 24 description: >- Verifizierungen, die am Vergleichstag erstellt wurden, pro lokaler Stunde ab 00:00 Uhr. total: type: integer minimum: 0 description: Bisher heute erstellte Verifizierungen. example: 165 previous_total_so_far: type: integer minimum: 0 description: >- Verifizierungen, die am Vergleichstag bis zur selben lokalen Uhrzeit erstellt wurden. example: 151 outcomes: type: object description: >- Von den heutigen Verifizierungen: wie viele aktuell genehmigt sind, in Prüfung warten oder abgelehnt wurden. Die restlichen sind noch nicht abgeschlossen. 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: >- Der API-Schlüssel Ihrer Anwendung, aus Entwickler -> API-Schlüssel in der Business Console. Der Primärschlüssel hat Vollzugriff. Ein benannter Schlüssel kann im Geltungsbereich eingeschränkt werden: keine, Lese- oder Schreibberechtigung pro Ressource, beschränkt auf bestimmte Workflows oder genehmigte Sitzungen, auf eine Liste von IP-Adressen und auf ein Ablaufdatum. 401 bedeutet, dass der Schlüssel falsch, widerrufen oder abgelaufen ist; 403 bedeutet, dass kein Schlüssel gesendet wurde, der Schlüssel keinen Zugriff auf diese Ressource oder Aktion hat oder die Anfrage von einer Adresse außerhalb seiner IP-Liste stammte; 404 bei einer Sitzungsroute bedeutet, dass die Sitzung außerhalb der Workflows oder Status des Schlüssels liegt. Ein Schlüssel ohne Medienzugriff erhält Bild-, Video- und PDF-URLs als null, und ein Schlüssel ohne Schreibberechtigung für Sitzungen erhält Sitzungslinks und Token als null. Siehe https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.