List telco data usage reports
Retrieve a paginated list of telco data usage reports
GET
/
legacy_reporting
/
usage_reports
/
number_lookup
JavaScript
import Telnyx from 'telnyx';
const client = new Telnyx({
apiKey: process.env['TELNYX_API_KEY'], // This is the default and can be omitted
});
const numberLookups = await client.legacy.reporting.usageReports.numberLookup.list();
console.log(numberLookups.data);import os
from telnyx import Telnyx
client = Telnyx(
api_key=os.environ.get("TELNYX_API_KEY"), # This is the default and can be omitted
)
number_lookups = client.legacy.reporting.usage_reports.number_lookup.list()
print(number_lookups.data)package main
import (
"context"
"fmt"
"github.com/team-telnyx/telnyx-go"
"github.com/team-telnyx/telnyx-go/option"
)
func main() {
client := telnyx.NewClient(
option.WithAPIKey("My API Key"),
)
numberLookups, err := client.Legacy.Reporting.UsageReports.NumberLookup.List(context.TODO())
if err != nil {
panic(err.Error())
}
fmt.Printf("%+v\n", numberLookups.Data)
}package com.telnyx.sdk.example;
import com.telnyx.sdk.client.TelnyxClient;
import com.telnyx.sdk.client.okhttp.TelnyxOkHttpClient;
import com.telnyx.sdk.models.legacy.reporting.usagereports.numberlookup.NumberLookupListParams;
import com.telnyx.sdk.models.legacy.reporting.usagereports.numberlookup.NumberLookupListResponse;
public final class Main {
private Main() {}
public static void main(String[] args) {
TelnyxClient client = TelnyxOkHttpClient.fromEnv();
NumberLookupListResponse numberLookups = client.legacy().reporting().usageReports().numberLookup().list();
}
}require "telnyx"
telnyx = Telnyx::Client.new(api_key: "My API Key")
number_lookups = telnyx.legacy.reporting.usage_reports.number_lookup.list
puts(number_lookups)<?php
require_once dirname(__DIR__) . '/vendor/autoload.php';
use Telnyx\Client;
use Telnyx\Core\Exceptions\APIException;
$client = new Client(apiKey: getenv('TELNYX_API_KEY') ?: 'My API Key');
try {
$numberLookups = $client->legacy->reporting->usageReports->numberLookup->list(
);
var_dump($numberLookups);
} catch (APIException $e) {
echo $e->getMessage();
}telnyx legacy:reporting:usage-reports:number-lookup list \
--api-key 'My API Key'curl --request GET \
--url https://api.telnyx.com/v2/legacy_reporting/usage_reports/number_lookup \
--header 'Authorization: Bearer <token>'{
"data": [
{
"id": "9783f4d7-0bfc-427a-9d6b-bc659ad16e5b",
"start_date": "2025-11-01",
"end_date": "2025-12-01",
"aggregation_type": "ALL",
"status": "COMPLETE",
"report_url": "https://portal-cdrs-usage.s3.amazonaws.com/telco_data_usage_report_2025-12-02.csv",
"created_at": "2025-12-02T20:20:57.196925Z",
"updated_at": "2025-12-02T20:21:08.237091Z",
"managed_accounts": [],
"result": [
{
"user_id": "d37bdd47-f301-42ec-b2ad-5a0465bfb632",
"aggregations": [
{
"type": "CNAM",
"total_dips": 3,
"total_cost": 0.009,
"currency": "USD"
}
],
"record_type": "TelcoDataUsageRecord"
}
],
"record_type": "TelcoDataUsageReport"
}
],
"meta": {
"total_pages": 3,
"total_results": 55,
"page_number": 2,
"page_size": 25
}
}Was this page helpful?
⌘I
JavaScript
import Telnyx from 'telnyx';
const client = new Telnyx({
apiKey: process.env['TELNYX_API_KEY'], // This is the default and can be omitted
});
const numberLookups = await client.legacy.reporting.usageReports.numberLookup.list();
console.log(numberLookups.data);import os
from telnyx import Telnyx
client = Telnyx(
api_key=os.environ.get("TELNYX_API_KEY"), # This is the default and can be omitted
)
number_lookups = client.legacy.reporting.usage_reports.number_lookup.list()
print(number_lookups.data)package main
import (
"context"
"fmt"
"github.com/team-telnyx/telnyx-go"
"github.com/team-telnyx/telnyx-go/option"
)
func main() {
client := telnyx.NewClient(
option.WithAPIKey("My API Key"),
)
numberLookups, err := client.Legacy.Reporting.UsageReports.NumberLookup.List(context.TODO())
if err != nil {
panic(err.Error())
}
fmt.Printf("%+v\n", numberLookups.Data)
}package com.telnyx.sdk.example;
import com.telnyx.sdk.client.TelnyxClient;
import com.telnyx.sdk.client.okhttp.TelnyxOkHttpClient;
import com.telnyx.sdk.models.legacy.reporting.usagereports.numberlookup.NumberLookupListParams;
import com.telnyx.sdk.models.legacy.reporting.usagereports.numberlookup.NumberLookupListResponse;
public final class Main {
private Main() {}
public static void main(String[] args) {
TelnyxClient client = TelnyxOkHttpClient.fromEnv();
NumberLookupListResponse numberLookups = client.legacy().reporting().usageReports().numberLookup().list();
}
}require "telnyx"
telnyx = Telnyx::Client.new(api_key: "My API Key")
number_lookups = telnyx.legacy.reporting.usage_reports.number_lookup.list
puts(number_lookups)<?php
require_once dirname(__DIR__) . '/vendor/autoload.php';
use Telnyx\Client;
use Telnyx\Core\Exceptions\APIException;
$client = new Client(apiKey: getenv('TELNYX_API_KEY') ?: 'My API Key');
try {
$numberLookups = $client->legacy->reporting->usageReports->numberLookup->list(
);
var_dump($numberLookups);
} catch (APIException $e) {
echo $e->getMessage();
}telnyx legacy:reporting:usage-reports:number-lookup list \
--api-key 'My API Key'curl --request GET \
--url https://api.telnyx.com/v2/legacy_reporting/usage_reports/number_lookup \
--header 'Authorization: Bearer <token>'{
"data": [
{
"id": "9783f4d7-0bfc-427a-9d6b-bc659ad16e5b",
"start_date": "2025-11-01",
"end_date": "2025-12-01",
"aggregation_type": "ALL",
"status": "COMPLETE",
"report_url": "https://portal-cdrs-usage.s3.amazonaws.com/telco_data_usage_report_2025-12-02.csv",
"created_at": "2025-12-02T20:20:57.196925Z",
"updated_at": "2025-12-02T20:21:08.237091Z",
"managed_accounts": [],
"result": [
{
"user_id": "d37bdd47-f301-42ec-b2ad-5a0465bfb632",
"aggregations": [
{
"type": "CNAM",
"total_dips": 3,
"total_cost": 0.009,
"currency": "USD"
}
],
"record_type": "TelcoDataUsageRecord"
}
],
"record_type": "TelcoDataUsageReport"
}
],
"meta": {
"total_pages": 3,
"total_results": 55,
"page_number": 2,
"page_size": 25
}
}