> ## 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의 Management API로 현지 시간대 기준 오늘의 시간대별 사용자 인증 건수를 조회하세요. 지난주 같은 요일과 승인됨, 검토 중, 거부됨 건수도 함께 확인할 수 있습니다. 오늘의 시간대별 인증 조회 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.`

\
붙여넣을 곳 Didit의 오늘의 시간대별 인증 조회 API는 요청에서 지정한 시간대 기준 자정부터 오늘 사용자 인증 건수를 시간대별로 반환하며, 같은 요일 지난주의 같은 시간대 데이터를 함께 제공합니다. Business Console 홈의 볼륨 카드에 표시되는 데이터이기도 합니다.| 필드 | 담고 있는 내용 | | - | - | | `hours` | 00:00부터 현지 시간 기준 시간별 오늘의 인증 건수입니다. 아직 오지 않은 시간대는 `0`입니다. | | `previous_hours` | 일주일 전 같은 요일인 `previous_date`의 동일한 시간대 값입니다. | | `total`, `previous_total_so_far` | 오늘 지금까지의 합계와, 비교 날짜의 같은 현지 시각까지의 합계입니다. | | `outcomes` | 오늘 인증 중 현재 `approved`, `in_review`, `declined` 상태인 건수입니다. |이 수치는 인증 데이터에서 실시간으로 읽어오므로, 방금 생성된 인증도 이미 포함됩니다. 날짜 범위와 기타 대시보드 수치는 [Get Application Analytics](https://docs.didit.me/ko/management-api/analytics/get.md)를 사용하세요.> [!NOTE] > > 전체 액세스 권한이 있는 API 키만 이 엔드포인트를 호출할 수 있습니다. 권한 수준과 관계없이 범위 제한 키는 `403`을 받으며, 다른 애플리케이션의 키도 마찬가지입니다. [API 키](https://docs.didit.me/ko/console/api-keys.md)를 참고하세요.## 관련 문서- [Get Application Analytics](https://docs.didit.me/ko/management-api/analytics/get.md) - [분석 대시보드](https://docs.didit.me/ko/console/analytics.md) - [API 키 및 범위 제한 액세스](https://docs.didit.me/ko/console/api-keys.md) ## OpenAPI ````yaml ko/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: >- `tz`의 현지 자정부터 생성된 현지 시간별 오늘의 사용자 인증(KYC) 세션을 일주일 전 같은 요일의 동일한 시간대와 비교하여 집계하고, 현재 각 세션의 결과(승인됨, 검토 중, 거부됨)별로 분류합니다. 이는 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: >- 이 API 키로 분당 600건을 초과하는 GET 요청이 발생했습니다. `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: 현재 1분 기간이 초기화될 때까지 남은 시간(초)입니다. 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: '비교 기준일: 1주 전 같은 요일입니다.' 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: >- Business Console의 Developers -> API keys에서 발급받은 귀하 애플리케이션의 API 키입니다. 기본 키는 전체 접근 권한을 갖습니다. 이름이 지정된 키는 리소스별 none, read, write 범위로 권한을 제한할 수 있으며 특정 워크플로나 승인된 세션, IP 주소 목록, 만료일 등으로 제한할 수도 있습니다. 401은 키가 잘못되었거나 폐기되었거나 만료되었음을 의미합니다. 403은 키가 전송되지 않았거나, 키에 해당 리소스나 작업에 대한 접근 권한이 없거나, 요청이 허용된 IP 목록 외부 주소에서 발생했음을 의미합니다. 세션 경로에서의 404는 해당 세션이 키의 허용 워크플로 또는 상태 범위를 벗어났음을 의미합니다. 미디어 접근 권한이 없는 키는 이미지, 비디오, PDF URL을 null로 수신하며, 세션 write 권한이 없는 키는 세션 링크와 token을 null로 수신합니다. https://docs.didit.me/console/api-keys 를 참고하십시오. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.