SIM Reporting & Analytics

In this article we will explain where to find your WDRs in the Telnyx Mission Control Portal and API. See Telnyx guidance and requirements.

How to Pull Your WDR CSV Report

Pull reports on WDRs from the Reporting section of the Portal - just like you would with MDRs (for messaging) or CDRs (for voice). WDR stands for wireless detail record and represents a single data session from your SIM card.

Report can be downloaded as a CSV and will include the following:

Record Opening Time (UTC)The time the related session was opened.
Telephone NumberTelephone number tied to your Telnyx SIM card.
Downlink Data (MB)Amount of data downloaded in the related session.
Uplink Data (MB)Amount of data uploaded in the related session.
SIM Card IDUUID for SIM card resource.
SIM Group IDUUID for SIM group resource.
Data Plan IDUUID for the related data plan resource. Data plans are only used for specific customer use cases.
Mobile Country Code (MCC)A unique code to check which country the SIM was being used.
Mobile Network Code (MNC)A unique code to check which carrier your SIM was connected to.
International Mobile Subscriber Identity (IMSI)Used to identify the user on the network similar to a MAC address.
Sim Card TagsA comma-separated list of associated tags.

Head to the Reporting tab in Mission Control:

How to Pull Your WDR JSON Analytics

You can also track your data usage analytics via our JSON API. The below cURL command will give you back a paginated response from our RESTful API with a single record per WDR:

curl --request GET \
  --url https://api.telnyx.com/v2/wireless/detail/records/reports/{id} \
  --header 'Authorization: Bearer <token>'

This command will respond with all session information from yesterday for your active SIM cards.

API specifications for this JSON endpoint can be viewed here.

The response will include the following fields:

closed_atDatetime in which the related session was closed.
created_atDatetime in which the related session was started.
currencyBilling currency.
data_costThe total cost of the data ran in this session.
data_rateThe unit price for each MB ran in this session.
data_unitThe unit of measurement for units in this session - nearly always MB.
downlink_dataAmount of data downloaded in the related session.
idUUID for this specific session.
imsiUsed to identify the user on the network similar to a MAC address.
ip_addressThe IP address that the SIM card had when this session was active.
is_telnyx_billableAlways true.
mccA unique code to check which country the SIM was being used.
mncA unique code to check which carrier your SIM was connected to.
phone_numberTelephone number tied to your Telnyx SIM card.
record_typeThe type of API resource that this is - it will always be wireless_detail_record
sim_card_idUUID for SIM card resource.
sim_card_tagsA comma-separated list of associated tags.
sim_group_idUUID for SIM group resource.
sim_group_nameThe name of the related SIM group at the time that the session was active.
uplink_dataAmount of data uploaded in the related session.

Video walkthroughs

Related articles

SIM Card Location and Device DetailsHow to view your SIM card's estimated location in the Mission Control Portal and API. See Telnyx guidance and requirements.SIM Card ActionsTrack every update made to your SIM cards with Telnyx's SIM card actions. See Telnyx guidance and requirements.SIM Data Limits & NotificationsIn this article, we will explain how you can set up data limits for your SIM groups and SIM cards and receive… See Telnyx guidance and requirements.SIM Card Theft PreventionSecure your SIM fleet with Telnyx. See Telnyx guidance and requirements Learn more about SIM Card Theft Prevention with Telnyx.