> ## 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は、送信したタイムゾーンの午前0時から数えた本日のユーザー認証件数を1時間ごとに返し、先週の同じ曜日の同じ時間帯の件数と並べて示します。Business Console のホームにある件数カードは、このデータを表示しています。| フィールド | 内容 | | - | - | | `hours` | 00:00から始まる、現地時間の1時間ごとの本日の認証件数です。まだ到来していない時間帯は`0`になります。 | | `previous_hours` | `previous_date`(1週間前の同じ曜日)の同じ時間帯の件数です。 | | `total`、`previous_total_so_far` | 本日これまでの件数と、比較対象日の同じ現地時刻までの件数です。 | | `outcomes` | 本日の認証のうち、現在`approved`、`in_review`、`declined`である件数です。 |認証データをリアルタイムで集計するため、作成された直後の認証もすでに集計に含まれます。期間を指定した集計やダッシュボードのその他の数値には、[アプリケーション分析の取得](https://docs.didit.me/ja/management-api/analytics/get.md)を使用してください。> [!NOTE] > > このエンドポイントを呼び出せるのは、フルアクセスのAPIキーのみです。スコープ付きのキーは、どのアクセス権を持っていても`403`を受け取ります。他のアプリケーションのキーも同様です。詳しくは[APIキー](https://docs.didit.me/ja/console/api-keys.md)を参照してください。## 関連情報- [アプリケーション分析を取得](https://docs.didit.me/ja/management-api/analytics/get.md) - [分析ダッシュボード](https://docs.didit.me/ja/console/analytics.md) - [APIキーとスコープ付きアクセス](https://docs.didit.me/ja/console/api-keys.md) ## OpenAPI ````yaml ja/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`における現地時間の午前0時から、作成された現地時間の時間帯ごとに集計し、1週間前の同じ曜日の同じ時間帯と並べ、それぞれが現在保持している結果(承認済み、レビュー中、却下)別に分けたものです。これは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: >- その深夜0時を今日の開始とする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キーで1分あたり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: この枠で1分あたりに許可されるリクエスト数。 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からの現地時間1時間ごとの件数。まだ到来していない時間帯は0です。 previous_hours: type: array items: type: integer minimum: 0 minItems: 24 maxItems: 24 description: 比較対象日に作成された認証の、00:00からの現地時間1時間ごとの件数。 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キーです。Business ConsoleのDevelopers -> API keysで取得できます。プライマリキーはフルアクセス権を持ちます。名前付きキーにはスコープを設定できます。リソースごとのアクセス権（なし、読み取り、書き込み）、一部のワークフローまたは承認済みセッションへの限定、IPアドレスのリストへの限定、有効期限の設定です。401は、キーが誤っている、失効している、または期限切れであることを意味します。403は、キーが送信されていない、キーにこのリソースやアクションへのアクセス権がない、またはIPリスト外のアドレスからリクエストが送信されたことを意味します。セッションのルートでの404は、セッションがキーのワークフローまたはステータスの対象外であることを意味します。メディアへのアクセス権がないキーでは、画像、動画、PDFのURLがnullで返されます。セッションの書き込み権限がないキーでは、セッションのリンクとトークンがnullで返されます。詳細は次を参照してください: https://docs.didit.me/console/api-keys ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.