> ## 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 верификаций за сегодня по часам > Верификации пользователей Didit за сегодня по местным часам, с тем же днём прошлой недели и статусами: одобрена, на проверке, отклонена. Промпт для API: верификации за сегодня по часам Скопировать промпт в буфер обмена \

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

\
Вставьте в API Didit для верификаций за сегодня по часам возвращает количество верификаций пользователей за сегодня по каждому часу, начиная с полуночи в часовом поясе, который вы передаёте. Рядом возвращаются данные за те же часы в тот же день недели на прошлой неделе. Эти данные лежат в основе карточки объёма на главной странице (Home) в Business Console.| Поле | Что содержит | | - | - | | `hours` | Количество верификаций за сегодня по каждому местному часу, начиная с 00:00. Часы, которые ещё не наступили, равны `0`. | | `previous_hours` | Те же часы для даты `previous_date`, то есть в тот же день недели на прошлой неделе. | | `total`, `previous_total_so_far` | Итог за сегодня на данный момент и итог за день сравнения до того же местного времени. | | `outcomes` | Из сегодняшних верификаций: сколько сейчас `approved`, `in_review` и `declined`. |Счётчики считываются в режиме реального времени из ваших верификаций, поэтому верификация, созданная только что, уже учтена. Для выборки за период и других показателей дашборда используйте [Получить аналитику приложения](https://docs.didit.me/ru/management-api/analytics/get.md).> [!NOTE] > > Вызывать этот endpoint может только API-ключ с полным доступом. Ключ с ограниченным доступом получает `403` независимо от того, какие у него права, и ключ другого приложения получает такой же ответ. См. [API-ключи](https://docs.didit.me/ru/console/api-keys.md).## Связанные материалы- [Получить аналитику приложения](https://docs.didit.me/ru/management-api/analytics/get.md) - [Дашборд аналитики](https://docs.didit.me/ru/console/analytics.md) - [API-ключи и ограниченный доступ](https://docs.didit.me/ru/console/api-keys.md) ## OpenAPI ````yaml ru/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 верификации личности. Аутентификация выполняется с помощью заголовка 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: Получить сегодняшние верификации по часам description: >- Сегодняшние сессии проверки пользователей (KYC) от местной полуночи в `tz`, подсчитанные по местным часам их создания, рядом с теми же часами того же дня недели неделю назад и с разбивкой по текущему результату: одобрена, на проверке или отклонена. Это карточка объёма на главной странице Business Console. `total` показывает итог за сегодня на данный момент. `previous_total_so_far` учитывает день сравнения только до того же местного времени, поэтому разница между ними сравнивает одну и ту же часть обоих дней. Часы, которые ещё не наступили сегодня, равны `0`. День с переводом часов содержит 23 или 25 часов: пропущенный час остаётся `0`, а повторяющийся час объединяет оба. operationId: get_application_analytics_today parameters: - name: organization_id in: path required: true schema: type: string format: uuid description: UUID организации. example: 11111111-2222-3333-4444-555555555555 - name: application_id in: path required: true schema: type: string format: uuid description: >- UUID приложения. Должно быть приложением, к которому относится API-ключ: при использовании ключа для любого другого приложения возвращается `403`. example: aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee - name: tz in: query required: false schema: type: string default: UTC example: Europe/Madrid description: >- Часовой пояс IANA, полночь которого начинает сегодняшние сутки, например `Europe/Madrid` или `America/Mexico_City`. Опустите для использования UTC. responses: '200': description: >- Сегодняшние верификации по местным часам, верификации дня сравнения и сегодняшние результаты. 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: >- Неизвестный часовой пояс. В теле ответа ключами являются параметры, для каждого из которых приведён список сообщений. 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: >- Срок действия API-ключа истёк. Истечь может только ключ, созданный со сроком действия; после этой даты каждый запрос с ним возвращает `401`. content: application/json: schema: type: object properties: detail: type: string examples: Expired key: value: detail: This API key has expired. '403': description: >- Запрос не разрешён. Проверьте `detail`: отсутствующий или недействительный API-ключ (никогда не `401`), ключ другого приложения, любой ключ с ограниченной областью действия или запрос не из списка IP-адресов ключа. 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: >- Более 600 GET-запросов в минуту с этим API-ключом. Подождите указанное в `Retry-After` количество секунд, затем повторите попытку. 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: Количество секунд до сброса текущего минутного окна. schema: type: integer example: 23 X-RateLimit-Limit: description: Количество разрешённых запросов в минуту в рамках этого бюджета. schema: type: integer X-RateLimit-Remaining: description: Количество оставшихся запросов в текущем окне. schema: type: integer X-RateLimit-Reset: description: Unix-время, когда окно сбрасывается. 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: >- Сегодняшние верификации по местным часам в сравнении с тем же днём недели на прошлой неделе. required: - time_zone - date - current_hour - previous_date - hours - previous_hours - total - previous_total_so_far - outcomes properties: time_zone: type: string description: Часовой пояс IANA, в котором указаны день и его часы. example: Europe/Madrid date: type: string format: date description: Сегодня в этом часовом поясе. example: '2026-10-30' current_hour: type: integer minimum: 0 maximum: 23 description: Текущий локальный час. example: 14 previous_date: type: string format: date description: 'День сравнения: тот же день недели неделей ранее.' example: '2026-10-23' hours: type: array items: type: integer minimum: 0 minItems: 24 maxItems: 24 description: >- Верификации, созданные сегодня, по часам местного времени начиная с 00:00. Для предстоящих часов значение равно 0. previous_hours: type: array items: type: integer minimum: 0 minItems: 24 maxItems: 24 description: >- Верификации, созданные в день сравнения, по часам местного времени начиная с 00:00. total: type: integer minimum: 0 description: Верификации, созданные сегодня к настоящему моменту. example: 165 previous_total_so_far: type: integer minimum: 0 description: Верификации, созданные в день сравнения к тому же местному времени. example: 151 outcomes: type: object description: >- Сколько из сегодняшних верификаций сейчас одобрено, находится на проверке и отклонено. Остальные ещё не завершены. 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: >- API-ключ вашего приложения из раздела «Разработчикам» -> «API-ключи» в Business Console. Основной ключ имеет полный доступ. Именованный ключ может иметь ограниченную область действия: без доступа, чтение или запись для каждого ресурса, ограничение определенными сценариями или одобренными сессиями, списком IP-адресов и сроком действия. 401 означает, что ключ неверен, отозван или его срок действия истек; 403 означает, что ключ не был передан, у ключа нет доступа к этому ресурсу или действию, либо запрос поступил с адреса вне его списка IP-адресов; 404 на маршруте сессии означает, что сессия не входит в сценарии или статусы ключа. Ключ без доступа к медиа получает URL изображений, видео и PDF как null, а ключ без прав на запись сессий получает ссылки на сессии и токены как null. См. https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.