> ## 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 verificações de hoje por hora > Veja na Didit as verificações de usuários de hoje por hora local, comparadas ao mesmo dia da semana passada: aprovadas, em revisão e recusadas. Prompt da API de verificações de hoje por hora Copiar o prompt para a área de transferência \

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

\
Colar em A API de verificações de hoje por hora da Didit retorna as verificações de usuários de hoje por hora, a partir da meia-noite no fuso horário que você enviar, ao lado das mesmas horas do mesmo dia da semana na semana anterior. São os dados por trás do cartão de volume na página inicial do Business Console.| Campo | O que contém | | - | - | | `hours` | As verificações de hoje por hora local, a partir de 00:00. As horas que ainda estão por vir são `0`. | | `previous_hours` | As mesmas horas em `previous_date`, o mesmo dia da semana uma semana antes. | | `total`, `previous_total_so_far` | Hoje até agora, e o dia de comparação até o mesmo horário local. | | `outcomes` | Das verificações de hoje, quantas estão `approved`, `in_review` e `declined` no momento. |As contagens são lidas em tempo real a partir das suas verificações, então uma verificação criada há um instante já é contabilizada. Para um intervalo de datas e os outros números do painel, use [Obter analytics da aplicação](https://docs.didit.me/pt-br/management-api/analytics/get.md).> [!NOTE] > > Somente uma chave de API com acesso total pode chamar este endpoint. Uma chave com escopo recebe `403`, independentemente do acesso que tenha, e o mesmo acontece com uma chave de outra aplicação. Consulte [Chaves de API](https://docs.didit.me/pt-br/console/api-keys.md).## Conteúdo relacionado- [Obter analytics da aplicação](https://docs.didit.me/pt-br/management-api/analytics/get.md) - [Painel de analytics](https://docs.didit.me/pt-br/console/analytics.md) - [Chaves de API e acesso com escopo](https://docs.didit.me/pt-br/console/api-keys.md) ## OpenAPI ````yaml pt-br/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 verificação de identidade. Autentique-se com o cabeçalho 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: Obter as verificações de hoje por hora description: >- Sessões de verificação de usuários (KYC) de hoje, a partir da meia-noite local em `tz`, contadas pela hora local em que foram criadas, ao lado das mesmas horas do mesmo dia da semana uma semana antes, e divididas pelo resultado que cada uma tem agora: aprovada, em revisão ou recusada. Este é o card de volume da página inicial do Business Console. `total` é o de hoje até o momento. `previous_total_so_far` conta o dia de comparação apenas até o mesmo horário local, de modo que uma variação entre eles compara a mesma parte de ambos os dias. As horas que ainda faltam hoje são `0`. Um dia em que os relógios mudam tem 23 ou 25 horas: a hora que falta fica em `0` e a hora repetida contém as duas. operationId: get_application_analytics_today parameters: - name: organization_id in: path required: true schema: type: string format: uuid description: UUID da organização. example: 11111111-2222-3333-4444-555555555555 - name: application_id in: path required: true schema: type: string format: uuid description: >- UUID da aplicação. Deve ser a aplicação à qual a chave de API pertence: uma chave usada em qualquer outra aplicação recebe `403`. example: aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee - name: tz in: query required: false schema: type: string default: UTC example: Europe/Madrid description: >- Fuso horário IANA cuja meia-noite marca o início de hoje, por exemplo `Europe/Madrid` ou `America/Mexico_City`. Omita-o para usar UTC. responses: '200': description: >- Verificações de hoje por hora local, as do dia de comparação e os resultados de hoje. 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 horário desconhecido. O corpo é indexado pelo parâmetro, com uma lista de mensagens. 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: >- A chave de API expirou. Somente uma chave criada com data de validade pode expirar; após essa data, toda requisição feita com ela responde `401`. content: application/json: schema: type: object properties: detail: type: string examples: Expired key: value: detail: This API key has expired. '403': description: >- A requisição não é permitida. Leia `detail`: uma chave de API ausente ou inválida (nunca `401`), uma chave de outra aplicação, qualquer chave com escopo ou uma requisição feita fora da lista de IPs da chave. 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: >- Mais de 600 requisições GET por minuto com esta chave de API. Aguarde o número de segundos indicado em `Retry-After` e tente novamente. 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 até a janela atual de um minuto ser reiniciada. schema: type: integer example: 23 X-RateLimit-Limit: description: Requisições permitidas por minuto nesta cota. schema: type: integer X-RateLimit-Remaining: description: Requisições restantes na janela atual. schema: type: integer X-RateLimit-Reset: description: Horário Unix em que a janela é reiniciada. 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: >- Verificações de hoje por hora local em comparação com o mesmo dia da semana na semana passada. required: - time_zone - date - current_hour - previous_date - hours - previous_hours - total - previous_total_so_far - outcomes properties: time_zone: type: string description: O fuso horário IANA em que estão o dia e suas horas. example: Europe/Madrid date: type: string format: date description: Hoje nesse fuso horário. example: '2026-10-30' current_hour: type: integer minimum: 0 maximum: 23 description: A hora local atual. example: 14 previous_date: type: string format: date description: 'O dia de comparação: o mesmo dia da semana, uma semana antes.' example: '2026-10-23' hours: type: array items: type: integer minimum: 0 minItems: 24 maxItems: 24 description: >- Verificações criadas hoje, por hora local a partir de 00:00. As horas que ainda não chegaram são 0. previous_hours: type: array items: type: integer minimum: 0 minItems: 24 maxItems: 24 description: >- Verificações criadas no dia de comparação, por hora local a partir de 00:00. total: type: integer minimum: 0 description: Verificações criadas hoje até o momento. example: 165 previous_total_so_far: type: integer minimum: 0 description: Verificações criadas no dia de comparação até o mesmo horário local. example: 151 outcomes: type: object description: >- Das verificações de hoje, quantas estão aprovadas, pendentes em revisão e recusadas no momento. As demais ainda não foram concluídas. 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: >- Chave de API da sua aplicação, em Developers -> API keys no Business Console. A chave principal tem acesso total. Uma chave nomeada pode ter escopo restrito: nenhum acesso, leitura ou escrita por recurso, limitada a alguns fluxos ou a sessões aprovadas, a uma lista de endereços IP e a uma data de validade. 401 significa que a chave está errada, revogada ou expirada; 403 significa que nenhuma chave foi enviada, que a chave não tem acesso a este recurso ou ação, ou que a requisição veio de um endereço fora da sua lista de IPs; 404 em uma rota de sessão significa que a sessão está fora dos fluxos ou status da chave. Uma chave sem acesso a mídia recebe URLs de imagem, vídeo e PDF como null, e uma chave sem permissão de escrita em sessões recebe links e tokens de sessão como null. Consulte https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.