> ## 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 Verifiche degli utenti di oggi per ora > Didit restituisce le verifiche degli utenti di oggi per ora locale, con il confronto con lo stesso giorno della settimana scorsa e gli esiti. Prompt per l'API Verifiche di oggi per ora Copia il prompt negli appunti \

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

\
Incolla in L'API Verifiche di oggi per ora di Didit restituisce le verifiche degli utenti di oggi per ogni ora, a partire da mezzanotte nel fuso orario che invii, accanto alle stesse ore dello stesso giorno della settimana precedente. Sono i dati alla base della card dei volumi nella Home della Business Console.| Campo | Contenuto | | - | - | | `hours` | Verifiche di oggi per ora locale, a partire dalle 00:00. Le ore future valgono `0`. | | `previous_hours` | Le stesse ore nel giorno `previous_date`, lo stesso giorno della settimana una settimana prima. | | `total`, `previous_total_so_far` | Il totale di oggi finora e il totale del giorno di confronto fino alla stessa ora locale. | | `outcomes` | Delle verifiche di oggi, quante risultano ora `approved`, `in_review` e `declined`. |I conteggi vengono letti in tempo reale dalle tue verifiche, quindi una verifica creata poco fa è già conteggiata. Per un intervallo di date e gli altri dati della dashboard, usa [Get Application Analytics](https://docs.didit.me/it/management-api/analytics/get.md).> [!NOTE] > > Solo una chiave API con accesso completo può chiamare questo endpoint. Una chiave con accesso limitato riceve sempre `403`, indipendentemente dagli accessi che possiede, e lo stesso vale per una chiave di un'altra applicazione. Vedi [Chiavi API](https://docs.didit.me/it/console/api-keys.md).## Correlati- [Get Application Analytics](https://docs.didit.me/it/management-api/analytics/get.md) - [Dashboard analitica](https://docs.didit.me/it/console/analytics.md) - [Chiavi API e accesso limitato](https://docs.didit.me/it/console/api-keys.md) ## OpenAPI ````yaml it/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 di verifica dell'identità. Autenticati con l'intestazione 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: Recupera le verifiche odierne per ora description: >- Sessioni di verifica degli utenti (KYC) di oggi, a partire dalla mezzanotte locale in `tz`, conteggiate per ora locale di creazione, affiancate alle stesse ore dello stesso giorno della settimana precedente e suddivise in base all'esito attuale di ciascuna: approvata, in revisione o rifiutata. Questa è la scheda del volume nella Home della Business Console. `total` rappresenta la giornata odierna fino a questo momento. `previous_total_so_far` conteggia il giorno di confronto solo fino alla stessa ora locale, consentendo di confrontare la stessa porzione di entrambi i giorni. Le ore rimanenti della giornata odierna sono pari a `0`. Un giorno in cui cambia l'ora ha 23 o 25 ore: l'ora mancante rimane `0` e l'ora ripetuta le include entrambe. operationId: get_application_analytics_today parameters: - name: organization_id in: path required: true schema: type: string format: uuid description: UUID dell'organizzazione. example: 11111111-2222-3333-4444-555555555555 - name: application_id in: path required: true schema: type: string format: uuid description: >- UUID dell'applicazione. Deve essere l'applicazione a cui appartiene la chiave API: una chiave utilizzata su qualsiasi altra applicazione riceve `403`. example: aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee - name: tz in: query required: false schema: type: string default: UTC example: Europe/Madrid description: >- Fuso orario IANA la cui mezzanotte dà inizio a oggi, ad esempio `Europe/Madrid` o `America/Mexico_City`. Omettilo per UTC. responses: '200': description: >- Verifiche di oggi per ora locale, quelle del giorno di confronto e gli esiti odierni. 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: >- Fuso orario sconosciuto. Il corpo è indicizzato per parametro, con un elenco di messaggi. 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 chiave API è scaduta. Solo una chiave creata con una data di scadenza può scadere; dopo tale data ogni richiesta inviata con essa risponde con `401`. content: application/json: schema: type: object properties: detail: type: string examples: Expired key: value: detail: This API key has expired. '403': description: >- La richiesta non è consentita. Consulta `detail`: chiave API mancante o non valida (mai `401`), chiave di un'altra applicazione, qualsiasi chiave con ambito o una richiesta proveniente dall'esterno dell'elenco IP della chiave. 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: >- Più di 600 richieste GET al minuto con questa chiave API. Attendi il numero di secondi indicato in `Retry-After`, quindi riprova. 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: >- Secondi fino al ripristino della finestra temporale corrente di un minuto. schema: type: integer example: 23 X-RateLimit-Limit: description: Richieste consentite al minuto per questo budget. schema: type: integer X-RateLimit-Remaining: description: Richieste rimanenti nell'intervallo corrente. schema: type: integer X-RateLimit-Reset: description: Ora Unix in cui la finestra si azzera. 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: >- Verifiche di oggi per ora locale rispetto allo stesso giorno della settimana scorsa. required: - time_zone - date - current_hour - previous_date - hours - previous_hours - total - previous_total_so_far - outcomes properties: time_zone: type: string description: >- Il fuso orario IANA a cui si riferiscono il giorno e i relativi orari. example: Europe/Madrid date: type: string format: date description: Oggi in quel fuso orario. example: '2026-10-30' current_hour: type: integer minimum: 0 maximum: 23 description: L'ora locale attuale. example: 14 previous_date: type: string format: date description: >- Il giorno di confronto: lo stesso giorno della settimana una settimana prima. example: '2026-10-23' hours: type: array items: type: integer minimum: 0 minItems: 24 maxItems: 24 description: >- Verifiche create oggi, per ora locale a partire dalle 00:00. Le ore non ancora trascorse sono pari a 0. previous_hours: type: array items: type: integer minimum: 0 minItems: 24 maxItems: 24 description: >- Verifiche create nel giorno di confronto, per ora locale a partire dalle 00:00. total: type: integer minimum: 0 description: Verifiche create oggi fino a questo momento. example: 165 previous_total_so_far: type: integer minimum: 0 description: >- Verifiche create nel giorno di confronto fino alla stessa ora locale. example: 151 outcomes: type: object description: >- Delle verifiche di oggi, quante sono approvate, in attesa di revisione e rifiutate al momento. Il resto non è ancora completato. 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 chiave API della tua applicazione, da Developers -> API keys nella Business Console. La chiave primaria ha accesso completo. Una chiave con nome può avere un ambito definito: nessuno, lettura o scrittura per risorsa, limitata ad alcuni workflow o a sessioni approvate, a un elenco di indirizzi IP e a una data di scadenza. 401 indica che la chiave è errata, revocata o scaduta; 403 indica che non è stata inviata alcuna chiave, che la chiave non ha accesso a questa risorsa o azione, oppure che la richiesta proviene da un indirizzo non incluso nel suo elenco IP; 404 su una route di sessione indica che la sessione non rientra nei workflow o negli stati previsti dalla chiave. Una chiave senza accesso ai media riceve gli URL di immagini, video e PDF come null, e una chiave senza permessi di scrittura sulle sessioni riceve link e token di sessione come null. Consulta https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.