> ## 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 Verifikasi Pengguna Hari Ini per Jam

> Ambil verifikasi pengguna Didit hari ini per jam lokal vs. hari yang sama minggu lalu, beserta jumlah disetujui, dalam peninjauan, dan ditolak.



Prompt API Dapatkan Verifikasi Hari Ini per Jam
        Salin prompt ke papan klip



      
      

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



      
      

Tempel ke

API Today's Verifications by Hour dari Didit mengembalikan verifikasi pengguna hari ini per jam, dimulai dari tengah malam di zona waktu yang Anda kirim, berdampingan dengan jam yang sama pada hari yang sama minggu lalu. Data ini adalah sumber kartu volume di Beranda Business Console.| Kolom | Isinya |
| - | - |
| `hours` | Verifikasi hari ini per jam lokal, mulai dari 00:00. Jam yang belum tiba bernilai `0`. |
| `previous_hours` | Jam yang sama pada `previous_date`, yaitu hari yang sama dalam minggu satu minggu sebelumnya. |
| `total`, `previous_total_so_far` | Hari ini sejauh ini, dan hari pembanding hingga waktu lokal yang sama. |
| `outcomes` | Dari verifikasi hari ini, berapa yang saat ini berstatus `approved`, `in_review` dan `declined`. |Jumlah dibaca langsung dari verifikasi Anda, sehingga verifikasi yang baru dibuat beberapa saat lalu sudah ikut dihitung. Untuk rentang tanggal dan angka dasbor lainnya, gunakan [Get Application Analytics](https://docs.didit.me/id/management-api/analytics/get.md).> [!NOTE]
>
> Hanya kunci API dengan akses penuh yang dapat memanggil endpoint ini. Kunci dengan akses terbatas selalu menerima `403`, apa pun aksesnya, begitu pula kunci dari aplikasi lain. Lihat [Kunci API](https://docs.didit.me/id/console/api-keys.md).## Terkait- [Get Application Analytics](https://docs.didit.me/id/management-api/analytics/get.md)
- [Dasbor analitik](https://docs.didit.me/id/console/analytics.md)
- [Kunci API dan akses terbatas](https://docs.didit.me/id/console/api-keys.md)


## OpenAPI

````yaml id/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 Verifikasi Identitas. Lakukan autentikasi dengan header 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: Dapatkan verifikasi hari ini berdasarkan jam
      description: >-
        Sesi verifikasi pengguna (KYC) hari ini, dari tengah malam lokal di
        `tz`, dihitung per jam lokal saat dibuat, disandingkan dengan jam yang
        sama pada hari yang sama seminggu sebelumnya, dan dibagi berdasarkan
        hasil yang dimiliki masing-masing sesi saat ini: disetujui, dalam
        peninjauan, atau ditolak. Ini adalah kartu volume di Beranda Business
        Console.


        `total` adalah hari ini sejauh ini. `previous_total_so_far` menghitung
        hari pembanding hanya sampai waktu lokal yang sama, sehingga perubahan
        di antara keduanya membandingkan bagian yang sama dari kedua hari
        tersebut. Jam-jam yang belum tiba hari ini bernilai `0`. Hari saat
        pergantian jam (daylight saving) memiliki 23 atau 25 jam: jam yang
        hilang tetap `0` dan jam yang berulang menampung keduanya.
      operationId: get_application_analytics_today
      parameters:
        - name: organization_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: UUID organisasi.
          example: 11111111-2222-3333-4444-555555555555
        - name: application_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: >-
            UUID aplikasi. Harus berupa aplikasi pemilik kunci API tersebut:
            kunci yang digunakan pada aplikasi lain mana pun akan mendapatkan
            `403`.
          example: aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee
        - name: tz
          in: query
          required: false
          schema:
            type: string
            default: UTC
            example: Europe/Madrid
          description: >-
            Zona waktu IANA yang tengah malamnya memulai hari ini, misalnya
            `Europe/Madrid` atau `America/Mexico_City`. Jangan sertakan untuk
            UTC.
      responses:
        '200':
          description: >-
            Verifikasi hari ini berdasarkan jam lokal, verifikasi pada hari
            pembanding, dan hasil hari ini.
          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 waktu tidak dikenal. Bagian body menggunakan parameter sebagai
            kunci, dengan daftar pesan.
          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: >-
            Kunci API telah kedaluwarsa. Hanya kunci yang dibuat dengan tanggal
            kedaluwarsa yang dapat kedaluwarsa; setelah tanggal tersebut, setiap
            permintaan dengannya menghasilkan respons `401`.
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
              examples:
                Expired key:
                  value:
                    detail: This API key has expired.
        '403':
          description: >-
            Permintaan tidak diizinkan. Baca `detail`: kunci API yang hilang
            atau tidak valid (tidak pernah `401`), kunci dari aplikasi lain,
            kunci dengan cakupan terbatas apa pun, atau permintaan dari luar
            daftar IP kunci.
          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: >-
            Lebih dari 600 permintaan GET per menit dengan kunci API ini. Tunggu
            selama jumlah detik di `Retry-After`, lalu coba lagi.
          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: Detik hingga jendela satu menit saat ini direset.
              schema:
                type: integer
                example: 23
            X-RateLimit-Limit:
              description: Permintaan yang diizinkan per menit dalam anggaran ini.
              schema:
                type: integer
            X-RateLimit-Remaining:
              description: Permintaan tersisa dalam jendela saat ini.
              schema:
                type: integer
            X-RateLimit-Reset:
              description: Waktu Unix saat jendela direset.
              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: >-
        Verifikasi hari ini berdasarkan jam lokal dibandingkan dengan hari yang
        sama minggu lalu.
      required:
        - time_zone
        - date
        - current_hour
        - previous_date
        - hours
        - previous_hours
        - total
        - previous_total_so_far
        - outcomes
      properties:
        time_zone:
          type: string
          description: Zona waktu IANA tempat hari dan jam tersebut berlangsung.
          example: Europe/Madrid
        date:
          type: string
          format: date
          description: Hari ini di zona waktu tersebut.
          example: '2026-10-30'
        current_hour:
          type: integer
          minimum: 0
          maximum: 23
          description: Jam lokal saat ini.
          example: 14
        previous_date:
          type: string
          format: date
          description: 'Hari perbandingan: hari kerja yang sama satu minggu sebelumnya.'
          example: '2026-10-23'
        hours:
          type: array
          items:
            type: integer
            minimum: 0
          minItems: 24
          maxItems: 24
          description: >-
            Verifikasi yang dibuat hari ini, per jam lokal mulai pukul 00:00.
            Jam-jam yang belum terlewati bernilai 0.
        previous_hours:
          type: array
          items:
            type: integer
            minimum: 0
          minItems: 24
          maxItems: 24
          description: >-
            Verifikasi yang dibuat pada hari pembanding, per jam lokal mulai
            pukul 00:00.
        total:
          type: integer
          minimum: 0
          description: Verifikasi yang dibuat hari ini sejauh ini.
          example: 165
        previous_total_so_far:
          type: integer
          minimum: 0
          description: >-
            Verifikasi yang dibuat pada hari pembanding hingga waktu lokal yang
            sama.
          example: 151
        outcomes:
          type: object
          description: >-
            Dari verifikasi hari ini, berapa banyak yang disetujui, menunggu
            dalam peninjauan, dan ditolak saat ini. Sisanya belum selesai.
          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: >-
        Kunci API aplikasi Anda, dari Developers -> API keys di Business
        Console. Kunci utama memiliki akses penuh. Kunci bernama dapat diberi
        cakupan: none, read, atau write per sumber daya, dibatasi pada beberapa
        alur kerja atau pada sesi yang disetujui, pada daftar alamat IP, dan
        pada tanggal kedaluwarsa. 401 berarti kuncinya salah, dicabut, atau
        kedaluwarsa; 403 berarti tidak ada kunci yang dikirimkan, kunci tidak
        memiliki akses ke sumber daya atau tindakan ini, atau permintaan datang
        dari alamat di luar daftar IP-nya; 404 pada rute sesi berarti sesi
        berada di luar alur kerja atau status kunci tersebut. Kunci tanpa akses
        media menerima URL gambar, video, dan PDF sebagai null, dan kunci tanpa
        izin tulis sesi menerima tautan sesi dan token sebagai null. Lihat
        https://docs.didit.me/console/api-keys.

````

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