> ## 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 verificaciones de hoy por hora

> Consulta con Didit las verificaciones de hoy por hora local, frente al mismo día de la semana pasada, con aprobadas, en revisión y rechazadas.



Prompt para la API de verificaciones de hoy por hora
        Copiar el prompt al portapapeles



      
      

\<pre>

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

\</pre>



      
      

Pegar en

La API de verificaciones de hoy por hora de Didit devuelve las verificaciones de usuarios de hoy por hora, desde la medianoche en la zona horaria que envíes, junto a las mismas horas del mismo día de la semana anterior. Estos son los datos en los que se basa la tarjeta de volumen en la página de inicio de la Business Console.| Campo | Qué contiene |
| - | - |
| `hours` | Las verificaciones de hoy por hora local, desde las 00:00. Las horas que aún no han llegado valen `0`. |
| `previous_hours` | Las mismas horas en `previous_date`, el mismo día de la semana una semana antes. |
| `total`, `previous_total_so_far` | Lo que va de hoy, y el día de comparación hasta la misma hora local. |
| `outcomes` | De las verificaciones de hoy, cuántas están ahora en `approved`, `in_review` y `declined`. |Los recuentos se leen en tiempo real a partir de tus verificaciones, así que una verificación creada hace un momento ya está contabilizada. Para un rango de fechas y las demás cifras del panel, usa [Obtener analíticas de la aplicación](https://docs.didit.me/es/management-api/analytics/get.md).> [!NOTE]
>
> Solo una clave de API con acceso completo puede invocar este endpoint. Una clave con alcance limitado recibe `403` sea cual sea el acceso que tenga, y lo mismo ocurre con una clave de otra aplicación. Consulta [Claves de API](https://docs.didit.me/es/console/api-keys.md).## Relacionado- [Obtener analíticas de la aplicación](https://docs.didit.me/es/management-api/analytics/get.md)
- [Panel de analíticas](https://docs.didit.me/es/console/analytics.md)
- [Claves de API y acceso con alcance limitado](https://docs.didit.me/es/console/api-keys.md)


## OpenAPI

````yaml es/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ón de identidad. Autentícate con el encabezado 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: Obtener las verificaciones de hoy por hora
      description: >-
        Sesiones de verificación de usuarios (KYC) de hoy, desde la medianoche
        local en `tz`, contadas por la hora local en la que se crearon, junto a
        las mismas horas del mismo día de la semana una semana antes, y
        desglosadas según el resultado que tiene cada una ahora: aprobada, en
        revisión o rechazada. Es la tarjeta de volumen de la página de inicio de
        Business Console.


        `total` es lo que va de hoy. `previous_total_so_far` cuenta el día de
        comparación solo hasta la misma hora local, de modo que una variación
        entre ambos compara la misma parte de los dos días. Las horas que aún
        quedan hoy valen `0`. Un día en que cambia la hora tiene 23 o 25 horas:
        la hora que falta se queda en `0` y la hora repetida contiene ambas.
      operationId: get_application_analytics_today
      parameters:
        - name: organization_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: UUID de la organización.
          example: 11111111-2222-3333-4444-555555555555
        - name: application_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: >-
            UUID de la aplicación. Debe ser la aplicación a la que pertenece la
            clave de API: una clave usada en cualquier otra aplicación recibe
            `403`.
          example: aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee
        - name: tz
          in: query
          required: false
          schema:
            type: string
            default: UTC
            example: Europe/Madrid
          description: >-
            Zona horaria IANA cuya medianoche marca el inicio de hoy, por
            ejemplo `Europe/Madrid` o `America/Mexico_City`. Omítela para usar
            UTC.
      responses:
        '200':
          description: >-
            Verificaciones de hoy por hora local, las del día de comparación y
            los resultados de hoy.
          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 horaria desconocida. El cuerpo está indexado por el parámetro,
            con una lista de mensajes.
          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 clave de API ha expirado. Solo puede expirar una clave creada con
            fecha de caducidad; a partir de esa fecha, toda solicitud que la use
            responde `401`.
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
              examples:
                Expired key:
                  value:
                    detail: This API key has expired.
        '403':
          description: >-
            La solicitud no está permitida. Lee `detail`: falta la clave de API
            o no es válida (nunca `401`), la clave es de otra aplicación, es
            cualquier clave con alcance limitado, o la solicitud llega desde
            fuera de la lista de IP de la clave.
          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 solicitudes GET por minuto con esta clave de API. Espera
            el número de segundos indicado en `Retry-After` y vuelve a
            intentarlo.
          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: Segundos hasta que se reinicia la ventana actual de un minuto.
              schema:
                type: integer
                example: 23
            X-RateLimit-Limit:
              description: Solicitudes permitidas por minuto en este presupuesto.
              schema:
                type: integer
            X-RateLimit-Remaining:
              description: Solicitudes restantes en la ventana actual.
              schema:
                type: integer
            X-RateLimit-Reset:
              description: Tiempo Unix en que se restablece la ventana.
              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: >-
        Verificaciones de hoy por hora local frente al mismo día de la semana de
        la semana pasada.
      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 horaria IANA en la que están el día y sus horas.
          example: Europe/Madrid
        date:
          type: string
          format: date
          description: La fecha de hoy en esa zona horaria.
          example: '2026-10-30'
        current_hour:
          type: integer
          minimum: 0
          maximum: 23
          description: La hora local actual.
          example: 14
        previous_date:
          type: string
          format: date
          description: 'El día de comparación: el mismo día de la semana, una semana antes.'
          example: '2026-10-23'
        hours:
          type: array
          items:
            type: integer
            minimum: 0
          minItems: 24
          maxItems: 24
          description: >-
            Verificaciones creadas hoy, por hora local desde las 00:00. Las
            horas que aún no han llegado valen 0.
        previous_hours:
          type: array
          items:
            type: integer
            minimum: 0
          minItems: 24
          maxItems: 24
          description: >-
            Verificaciones creadas en el día de comparación, por hora local
            desde las 00:00.
        total:
          type: integer
          minimum: 0
          description: Verificaciones creadas hoy hasta el momento.
          example: 165
        previous_total_so_far:
          type: integer
          minimum: 0
          description: >-
            Verificaciones creadas en el día de comparación hasta la misma hora
            local.
          example: 151
        outcomes:
          type: object
          description: >-
            De las verificaciones de hoy, cuántas están aprobadas, en espera de
            revisión y rechazadas en este momento. El resto aún no ha terminado.
          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 clave de API de tu aplicación, que encontrarás en Developers -> API
        keys en la Business Console. La clave principal tiene acceso completo.
        Una clave con nombre puede tener un alcance limitado: ninguno, lectura o
        escritura por recurso, limitada a algunos flujos o a sesiones aprobadas,
        a una lista de direcciones IP y a una fecha de caducidad. 401 significa
        que la clave es incorrecta, se revocó o expiró; 403 significa que no se
        envió ninguna clave, que la clave no tiene acceso a este recurso o
        acción, o que la solicitud provino de una dirección fuera de su lista de
        IP; 404 en una ruta de sesión significa que la sesión está fuera de los
        flujos o estados de la clave. Una clave sin acceso a contenido
        multimedia recibe las URL de imágenes, videos y PDF como null, y una
        clave sin permiso de escritura en sesiones recibe los enlaces y tokens
        de sesión como null. Consulta https://docs.didit.me/console/api-keys.

````

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