Analytics and Logs Overview

The Verify Analytics and Logs sections in the Developer Dashboard allow you to monitor, search, and analyze activity associated with the Verify API. These tools offer valuable insights into the request data to help you understand your API usage and performance.

In this document, you can learn about:

• Verify Analytics - aggregated metrics and data from your Verify API.
• Verify Logs - transactions of your Verify requests.

Verify Analytics

The Verify Analytics section allows you to investigate and analyze aggregated metrics and data related to the Verify API usage and performance.

In this subsection, you will learn how to:

• Access Verify Analytics page.
• Interpret Verify Analytics view.

Access Verify Analytics

To access the Verify Analytics page:

1. Go to the Developer Dashboard -> Analytics.
2. Click Verify V2 Analytics.

Verify Analytics View

Once you open the Verify V2 Analytics page, you are taken to a dedicated view that presents insights into your Verify API usage and performance. This view includes a high-level summary of total requests, with detailed breakdowns by country and communication channel.

You also have the option to download the data as an Excel report by selecting the Download report button.

Verify Requests Tab

The Verify requests tab provides overall metrics for Verify API requests across a specific date range. It allows you to filter results using predefined time options or a custom date and time range.

The graph presents metrics:

• Total requests - Total number of Verify API requests made within the selected date range.
• Successful - Number of converted (successful) requests.
• Unsuccessful - Number of requests other than successful (failed, expired, rejected, user_rejected, canceled, blocked).

Beneath the graph, the table presents the request data broken down by months or weeks, depending on the filter selected. The table includes:

• Month - The month in which the request(s) were made.
• Usage - Number of requests made during that period.
• Successful - Number of converted (successful) requests.
• Unsuccessful - Number of requests other than successful (failed, expired, rejected, user_rejected, canceled, blocked).
• Verify fee - Verify platform fee only.
• Total cost - Verify platform fee plus the channel fee, depending on which channel(s) are used. For customers on Success pricing, the Total cost equals the Verify fee since no channel fee is charged. For customers not paying the Verify fee, the Total cost equals only the channel fee.

Channel Events Tab

The Channel events tab allows you to see how many requests were made for each supported channel.

The graph represents the metrics and allows you to control what data is displayed:

• Products - Specifies how many requests were made per channel. You can toggle specific channels on or off.
• Product usage:
  • Total events - Total events made, represented by the lines. Toggle to display or hide total event counts.
  • Cost - Total charge, represented by the bars. Toggle to display or hide associated channel costs.

Beneath the graph, the table presents the Channels and Countries breakdowns. It includes:

• Country - Countries for which requests were made (column displayed only in the Countries view tab).
• Channels - Channels for which requests were made.
• Events - Total number of requests made for each country and channel.
• Delivered - Number of successfully delivered requests.
• Not Delivered - Number of requests other than delivered (failed, expired, rejected, canceled, blocked).
• Total channel cost - The associated channel fees. For customers on Success Pricing, this value is always zero, since only the Verify fee is applied.

Verify Logs

The Verify Logs section allows you to explore and analyze transactions of your Verify requests.

In this subsection, you will learn how to:

• Access Verify Logs page.
• Interpret the Search verification requests view.
• Interpret the Search verification requests table.

Access Verify Logs

To access the Verify Logs page:

1. Go to the Developer Dashboard -> Logs.
2. Click Verify Logs -> Verify V2.

Search Verification Requests View

After opening the Verify Logs page, you are redirected to the Search verification requests view.

The view allows you to search your logs by:

• Time range - Search up to 30 days of data using options from the dropdown, or by selecting the custom time range and date. For logs older than 30 days, you need to use the Reports API.
• Phone Number - Search logs by entering the ‘To’ number and selecting a Time range.
• Request ID - Search for specific logs by their Request IDs.

After selecting your filters, the table displaying all the matching results will be shown. Because Verify supports various channels, each Verify request you initiate results in distinct requests:

• One for Verify itself, represented by v2 in the results.
• Another one(s) for the specific channel(s) being used.

That is why the table always shows multiple requests for each of the Verify requests made.

Search Verification Requests Table

The Search verification requests table displays detailed information for each request returned by your filters.

You can find the following columns in the table with the results:

• Request Id & API key - Identifies a specific request and its API key.
• Date - Time when the request was made.
• Phone Number - The destination phone number to which the request was made.
• Network - The network associated with the phone number.
• Channel - Shows which channel the request belongs to:
  • v2 - specific for the Verify request. Represents the verify platform fee record.
  • email - specific for the Email channel request.
  • silent auth - specific for the Silent Authentication channel request.
• Status - Shows the status of the Verify requests. Refer to the Status table for details on each status.
• Price - Pertains to the Verify fee and the associated channel fee for each individual record.

Interpreting Search Verification Requests Table

When interpreting the Search verification requests table, remember that Verify logs display each request separately, even when multiple channels are used within a single verification flow. Each attempt is logged independently, with its own channel, status, price, etc. As a result, a single verification may generate multiple log records: one for the v2 request and additional ones for each channel involved.

For example, when Silent Authentication and SMS are used together, and the request fails over from Silent Authentication to SMS, the related requests appear separately:

• The silent_auth request appears with a status of FAILED.
• The SMS request appears with a status of DELIVERED.

This behavior is expected, as each channel attempt is processed and logged independently.

Status Table

The table presents the details for each status of Verify requests: