Skip to main content
GET
curl
Didit’s Today’s Verifications by Hour API returns today’s user verifications per hour, from midnight in the time zone you send, next to the same hours of the same weekday last week. It is the data behind the volume card on the Business Console’s Home. The counts are read live from your verifications, so a verification created a moment ago is already counted. For a date range and the other dashboard figures, use Get Application Analytics.
Only a full-access API key can call this endpoint. A scoped key gets 403 whatever access it holds, and so does a key of another application. See API keys.

Authorizations

x-api-key
string
header
required

Your application's API key, from Developers -> API keys in the Business Console. The primary key has full access. A named key can be scoped: none, read or write per resource, limited to some workflows or to approved sessions, to a list of IP addresses, and to an expiry date. 401 means the key is wrong, revoked or expired; 403 means no key was sent, the key has no access to this resource or action, or the request came from an address outside its IP list; 404 on a session route means the session is outside the key's workflows or statuses. A key without media access receives image, video and PDF URLs as null, and a key without sessions write receives session links and tokens as null. See https://docs.didit.me/console/api-keys.

Path Parameters

organization_id
string<uuid>
required

Organization UUID.

application_id
string<uuid>
required

Application UUID. Must be the application the API key belongs to: a key used on any other application gets 403.

Query Parameters

tz
string
default:UTC

IANA time zone whose midnight starts today, for example Europe/Madrid or America/Mexico_City. Omit it for UTC.

Example:

"Europe/Madrid"

Response

Today's verifications by local hour, the comparison day's, and today's outcomes.

Today's verifications by local hour against the same weekday last week.

time_zone
string
required

The IANA time zone the day and its hours are in.

Example:

"Europe/Madrid"

date
string<date>
required

Today in that time zone.

Example:

"2026-10-30"

current_hour
integer
required

The local hour it is now.

Required range: 0 <= x <= 23
Example:

14

previous_date
string<date>
required

The comparison day: the same weekday one week before.

Example:

"2026-10-23"

hours
integer[]
required

Verifications created today, per local hour from 00:00. The hours still to come are 0.

Required array length: 24 elements
Required range: x >= 0
previous_hours
integer[]
required

Verifications created on the comparison day, per local hour from 00:00.

Required array length: 24 elements
Required range: x >= 0
total
integer
required

Verifications created today so far.

Required range: x >= 0
Example:

165

previous_total_so_far
integer
required

Verifications created on the comparison day up to the same local time.

Required range: x >= 0
Example:

151

outcomes
object
required

Of today's verifications, how many are approved, waiting in review and declined now. The rest are not finished yet.

Last modified on October 31, 2026