> ## 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 verificacions d'avui per hora > Consulta amb Didit les verificacions d'avui per hora local, amb el mateix dia de la setmana passada i quantes són aprovades, en revisió o rebutjades. Prompt per obtenir les verificacions d'avui per hora Copia el prompt al porta-retalls \

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

\
Enganxa a L'API de verificacions d'avui per hora de Didit retorna les verificacions d'usuaris d'avui per hora, des de mitjanit en la zona horària que envies, al costat de les mateixes hores del mateix dia de la setmana de la setmana passada. És la informació que hi ha darrere de la targeta de volum de la pàgina Home de la Business Console.| Camp | Què conté | | - | - | | `hours` | Les verificacions d'avui per hora local, a partir de les 00:00. Les hores que encara no han arribat són `0`. | | `previous_hours` | Les mateixes hores el dia indicat a `previous_date`, el mateix dia de la setmana d'una setmana abans. | | `total`, `previous_total_so_far` | Avui fins ara, i el dia de comparació fins a la mateixa hora local. | | `outcomes` | De les verificacions d'avui, quantes estan `approved`, `in_review` i `declined` ara mateix. |Els recomptes es llegeixen en temps real a partir de les teves verificacions, així que una verificació creada fa un moment ja s'hi compta. Per a un interval de dates i els altres indicadors del tauler, fes servir [Obtén les analítiques de l'aplicació](https://docs.didit.me/ca/management-api/analytics/get.md).> [!NOTE] > > Només una clau d'API d'accés complet pot cridar aquest endpoint. Una clau amb accés limitat rep `403` independentment de l'accés que tingui, i també ho rep una clau d'una altra aplicació. Consulta [Claus d'API](https://docs.didit.me/ca/console/api-keys.md).## Relacionats- [Obtén les analítiques de l'aplicació](https://docs.didit.me/ca/management-api/analytics/get.md) - [Tauler d'analítiques](https://docs.didit.me/ca/console/analytics.md) - [Claus d'API i accés limitat](https://docs.didit.me/ca/console/api-keys.md) ## OpenAPI ````yaml ca/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 verificació d'identitat. Autentica't amb la capçalera 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 verificacions d'avui per hora description: >- Sessions de verificació d'usuaris (KYC) d'avui, des de la mitjanit local a `tz`, comptades per hora local en què es van crear, al costat de les mateixes hores del mateix dia de la setmana d'una setmana abans, i desglossades pel resultat que té cadascuna ara mateix: aprovada, en revisió o rebutjada. Aquesta és la targeta de volum de la pàgina d'inici de la Business Console. `total` és el total d'avui fins ara. `previous_total_so_far` compta el dia de comparació només fins a la mateixa hora local, de manera que un canvi entre ells compara la mateixa part d'ambdós dies. Les hores que encara falten avui tenen valor `0`. Un dia en què canvia l'hora té 23 o 25 hores: l'hora que falta es manté a `0` i l'hora repetida les inclou totes dues. operationId: get_application_analytics_today parameters: - name: organization_id in: path required: true schema: type: string format: uuid description: UUID de l'organització. example: 11111111-2222-3333-4444-555555555555 - name: application_id in: path required: true schema: type: string format: uuid description: >- UUID de l'aplicació. Ha de ser l'aplicació a la qual pertany la clau d'API: una clau utilitzada en qualsevol altra aplicació rep un `403`. example: aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee - name: tz in: query required: false schema: type: string default: UTC example: Europe/Madrid description: >- Zona horària IANA la mitjanit de la qual comença avui, per exemple `Europe/Madrid` o `America/Mexico_City`. Omet-la per utilitzar UTC. responses: '200': description: >- Verificacions d'avui per hora local, les del dia de comparació i els resultats d'avui. 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: >- Zona horària desconeguda. El cos té com a claus els paràmetres, amb una llista de missatges. 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 clau d'API ha caducat. Només pot caducar una clau creada amb data de caducitat; després d'aquesta data, cada sol·licitud que s'hi faci rep una resposta `401`. content: application/json: schema: type: object properties: detail: type: string examples: Expired key: value: detail: This API key has expired. '403': description: >- La sol·licitud no està permesa. Consulta `detail`: una clau d'API absent o invàlida (mai `401`), una clau d'una altra aplicació, qualsevol clau amb àmbit o una sol·licitud des de fora de la llista d'adreces IP de la clau. 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: >- Més de 600 sol·licituds GET per minut amb aquesta clau d'API. Espera el nombre de segons indicat a `Retry-After` i torna-ho a provar. 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: Segons fins que es restableixi la finestra actual d'un minut. schema: type: integer example: 23 X-RateLimit-Limit: description: Sol·licituds permeses per minut en aquest pressupost. schema: type: integer X-RateLimit-Remaining: description: Sol·licituds restants a la finestra actual. schema: type: integer X-RateLimit-Reset: description: Temps Unix en què es reinicia la finestra. 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: >- Verificacions d'avui per hora local respecte al mateix dia de la setmana de la setmana passada. required: - time_zone - date - current_hour - previous_date - hours - previous_hours - total - previous_total_so_far - outcomes properties: time_zone: type: string description: La zona horària IANA corresponent al dia i a les seves hores. example: Europe/Madrid date: type: string format: date description: Avui en aquesta zona horària. example: '2026-10-30' current_hour: type: integer minimum: 0 maximum: 23 description: L'hora local que és ara. example: 14 previous_date: type: string format: date description: 'El dia de comparació: el mateix dia de la setmana una setmana abans.' example: '2026-10-23' hours: type: array items: type: integer minimum: 0 minItems: 24 maxItems: 24 description: >- Verificacions creades avui, per hora local a partir de les 00:00. Les hores que encara han de venir són 0. previous_hours: type: array items: type: integer minimum: 0 minItems: 24 maxItems: 24 description: >- Verificacions creades el dia de comparació, per hora local a partir de les 00:00. total: type: integer minimum: 0 description: Verificacions creades avui fins ara. example: 165 previous_total_so_far: type: integer minimum: 0 description: >- Verificacions creades el dia de comparació fins a la mateixa hora local. example: 151 outcomes: type: object description: >- De les verificacions d'avui, quantes estan aprovades, pendents en revisió i rebutjades ara mateix. La resta encara no ha finalitzat. 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 clau d'API de la teva aplicació, des de Developers -> API keys a la Business Console. La clau primària té accés complet. Una clau amb nom pot tenir l'abast limitat: cap, lectura o escriptura per recurs, limitada a determinats fluxos de treball o a sessions aprovades, a una llista d'adreces IP i a una data de caducitat. 401 significa que la clau és incorrecta, revocada o caducada; 403 significa que no s'ha enviat cap clau, que la clau no té accés a aquest recurs o acció, o que la sol·licitud prové d'una adreça fora de la seva llista d'IP; 404 en una ruta de sessió significa que la sessió està fora dels fluxos de treball o estats de la clau. Una clau sense accés a fitxers multimèdia rep els URL d'imatge, vídeo i PDF com a null, i una clau sense permís d'escriptura de sessions rep els enllaços de sessió i els tokens com a null. Consulta https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.