35+ countries live across 4 regions

For your reviewers

Elsewhere

Get your coverage map

qdr_history

The qdr_history command provides a chronological record of every instance a specific mobile number has appeared in the Query Detail Record (QDR) database. This API is used to establish a "digital footprint" for a mobile identity, allowing businesses to distinguish between established, active numbers and recently created or dormant ones. By verifying long-term activity patterns, it serves as a powerful indicator of legitimacy for risk engines and identity verification workflows.

A Query Detail Record (QDR) is a metadata log generated whenever an organization queries for the correct routing information of a mobile number to deliver a call or SMS. Unlike a Call Detail Record (CDR) which logs the call itself, a QDR captures the intent to communicate. Because these records stem from real-time communication attempts by legitimate companies, a match in this archive of over 70 billion records proves the number was active and genuine at that specific timestamp.

Response Reference

Field Format Description Always present?
service Number Code that denotes the service that generated the QDR. Yes
source Number Code that denotes which customer performed the query (i.e. is it always the same customer or a blend?). Yes
plm_network Number The owning network at the time of the query, expressed as a combination of Mobile Network Code (MNC) and Mobile Country Code (MCC). Yes
ts Timestamp Date and time (in UTC) when the query was performed. Yes

Note: If there are no historical QDRs associated with the supplied number, none will be provided in the response.

Summary Table

Command Description Response Values
qdr_history Retrieves a historical log of real-time routing queries to verify a number's long-term activity and legitimacy.
  • ts: Date and time (UTC) of the historical query
  • plm_network: The owning network (MCC/MNC) at the time of the record
  • service: Code denoting the internal service that generated the record
  • source: Code denoting the type of customer that performed the query

Read this in the portal, with search and the reference beside it: Qdr History