SIM Reporting & Analytics

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

Telnyx Engineering avatar
Written by Telnyx Engineering
Updated over a week ago

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 Number

Telephone 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 ID

UUID for SIM card resource.

SIM Group ID

UUID for SIM group resource.

Data Plan ID

UUID 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 Tags

A 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 -X GET \
--header "Content-Type: application/json" \
--header "Accept: application/json" \
--header "Authorization: Bearer YOUR_API_KEY" \
--globoff "https://api.telnyx.com/v2/detail_records?filter[record_type]=wireless_detail_record&filter[date_range]=yesterday"

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_at

Datetime in which the related session was closed.

created_at

Datetime in which the related session was started.

currency

Billing currency.

data_cost

The total cost of the data ran in this session.

data_rate

The unit price for each MB ran in this session.

data_unit

The unit of measurement for units in this session - nearly always MB.

downlink_data

Amount of data downloaded in the related session.

id

UUID for this specific session.

imsi

Used to identify the user on the network similar to a MAC address.

ip_address

The IP address that the SIM card had when this session was active.

is_telnyx_billable

Always true.

mcc

A unique code to check which country the SIM was being used.

mnc

A unique code to check which carrier your SIM was connected to.

phone_number

Telephone number tied to your Telnyx SIM card.

record_type

The type of API resource that this is - it will always be wireless_detail_record

sim_card_id

UUID for SIM card resource.

sim_card_tags

A comma-separated list of associated tags.

sim_group_id

UUID for SIM group resource.

sim_group_name

The name of the related SIM group at the time that the session was active.

uplink_data

Amount of data uploaded in the related session.

Did this answer your question?