List reputation-monitored phone numbers for an enterprise
Paginated list of phone numbers registered for reputation monitoring under this enterprise. The response includes the latest reputation snapshot per number where one has been collected.
import Telnyx from 'telnyx';
const client = new Telnyx({
apiKey: process.env['TELNYX_API_KEY'], // This is the default and can be omitted
});
// Automatically fetches more pages as needed.
for await (const numberListResponse of client.enterprises.reputation.numbers.list(
'4a6192a4-573d-446d-b3ce-aff9117272a6',
)) {
console.log(numberListResponse.id);
}import os
from telnyx import Telnyx
client = Telnyx(
api_key=os.environ.get("TELNYX_API_KEY"), # This is the default and can be omitted
)
page = client.enterprises.reputation.numbers.list(
enterprise_id="4a6192a4-573d-446d-b3ce-aff9117272a6",
)
page = page.data[0]
print(page.id)
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"),
)
page, err := client.Enterprises.Reputation.Numbers.List(
context.TODO(),
"4a6192a4-573d-446d-b3ce-aff9117272a6",
telnyx.EnterpriseReputationNumberListParams{},
)
if err != nil {
panic(err.Error())
}
fmt.Printf("%+v\n", page)
}
package com.telnyx.sdk.example;
import com.telnyx.sdk.client.TelnyxClient;
import com.telnyx.sdk.client.okhttp.TelnyxOkHttpClient;
import com.telnyx.sdk.models.enterprises.reputation.numbers.NumberListPage;
import com.telnyx.sdk.models.enterprises.reputation.numbers.NumberListParams;
public final class Main {
private Main() {}
public static void main(String[] args) {
TelnyxClient client = TelnyxOkHttpClient.fromEnv();
NumberListPage page = client.enterprises().reputation().numbers().list("4a6192a4-573d-446d-b3ce-aff9117272a6");
}
}require "telnyx"
telnyx = Telnyx::Client.new(api_key: "My API Key")
page = telnyx.enterprises.reputation.numbers.list("4a6192a4-573d-446d-b3ce-aff9117272a6")
puts(page)<?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 {
$page = $client->enterprises->reputation->numbers->list(
'4a6192a4-573d-446d-b3ce-aff9117272a6',
filterPhoneNumberContains: '+16035551234',
filterPhoneNumberEq: '+16035551234',
pageNumber: 1,
pageSize: 10,
);
var_dump($page);
} catch (APIException $e) {
echo $e->getMessage();
}telnyx enterprises:reputation:numbers list \
--api-key 'My API Key' \
--enterprise-id 4a6192a4-573d-446d-b3ce-aff9117272a6curl --request GET \
--url https://api.telnyx.com/v2/enterprises/{enterprise_id}/reputation/numbers \
--header 'Authorization: Bearer <token>'{
"data": [
{
"id": "8a4b1f5e-2f12-4c0c-9a98-9b3a7d8b8e62",
"enterprise_id": "4a6192a4-573d-446d-b3ce-aff9117272a6",
"phone_number": "+19493253498",
"source": "external",
"ownership_status": "verified",
"flag_reason": "carrier_changed",
"confirm_by": "2026-10-08T07:00:00Z",
"removed_at": "2026-10-09T06:02:11Z",
"removal_reason": "unconfirmed_ownership",
"reputation_data": {
"spam_risk": "low",
"spam_category": null,
"maturity_score": 72,
"connection_score": 80,
"engagement_score": 64,
"sentiment_score": 75,
"last_refreshed_at": "2026-04-26T18:09:24.785211Z"
},
"created_at": "2026-04-26T18:06:51.940749Z",
"updated_at": "2026-04-26T18:09:24.785211Z"
}
],
"meta": {
"total_pages": 3,
"total_results": 42,
"page_number": 1,
"page_size": 20
}
}Authorizations
Telnyx API key. Generate one at https://portal.telnyx.com/#/app/api-keys.
Path Parameters
Query Parameters
Only numbers with this ownership status. removed lists the numbers that were removed, each with its removal_reason and removed_at; removed numbers are not returned otherwise.
Result of ongoing ownership checks. verified: the number is with the carrier on record. pending_confirmation: the number's carrier changed, or a periodic ownership re-verification is due; confirm you still own it before confirm_by. flagged: a periodic re-verification went unanswered; the number stays monitored and is not removed, but confirm ownership (POST .../ownership_confirm) to return it to verified. removed: the number is no longer monitored; returned by POST .../ownership_confirm with still_own: false, and when listing numbers with filter[ownership_status]=removed.
verified, flagged, pending_confirmation, removed "verified"
Response
Paginated list of numbers with reputation data.
List of reputation-monitored phone numbers, each carrying its current reputation data.
Was this page helpful?
import Telnyx from 'telnyx';
const client = new Telnyx({
apiKey: process.env['TELNYX_API_KEY'], // This is the default and can be omitted
});
// Automatically fetches more pages as needed.
for await (const numberListResponse of client.enterprises.reputation.numbers.list(
'4a6192a4-573d-446d-b3ce-aff9117272a6',
)) {
console.log(numberListResponse.id);
}import os
from telnyx import Telnyx
client = Telnyx(
api_key=os.environ.get("TELNYX_API_KEY"), # This is the default and can be omitted
)
page = client.enterprises.reputation.numbers.list(
enterprise_id="4a6192a4-573d-446d-b3ce-aff9117272a6",
)
page = page.data[0]
print(page.id)
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"),
)
page, err := client.Enterprises.Reputation.Numbers.List(
context.TODO(),
"4a6192a4-573d-446d-b3ce-aff9117272a6",
telnyx.EnterpriseReputationNumberListParams{},
)
if err != nil {
panic(err.Error())
}
fmt.Printf("%+v\n", page)
}
package com.telnyx.sdk.example;
import com.telnyx.sdk.client.TelnyxClient;
import com.telnyx.sdk.client.okhttp.TelnyxOkHttpClient;
import com.telnyx.sdk.models.enterprises.reputation.numbers.NumberListPage;
import com.telnyx.sdk.models.enterprises.reputation.numbers.NumberListParams;
public final class Main {
private Main() {}
public static void main(String[] args) {
TelnyxClient client = TelnyxOkHttpClient.fromEnv();
NumberListPage page = client.enterprises().reputation().numbers().list("4a6192a4-573d-446d-b3ce-aff9117272a6");
}
}require "telnyx"
telnyx = Telnyx::Client.new(api_key: "My API Key")
page = telnyx.enterprises.reputation.numbers.list("4a6192a4-573d-446d-b3ce-aff9117272a6")
puts(page)<?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 {
$page = $client->enterprises->reputation->numbers->list(
'4a6192a4-573d-446d-b3ce-aff9117272a6',
filterPhoneNumberContains: '+16035551234',
filterPhoneNumberEq: '+16035551234',
pageNumber: 1,
pageSize: 10,
);
var_dump($page);
} catch (APIException $e) {
echo $e->getMessage();
}telnyx enterprises:reputation:numbers list \
--api-key 'My API Key' \
--enterprise-id 4a6192a4-573d-446d-b3ce-aff9117272a6curl --request GET \
--url https://api.telnyx.com/v2/enterprises/{enterprise_id}/reputation/numbers \
--header 'Authorization: Bearer <token>'{
"data": [
{
"id": "8a4b1f5e-2f12-4c0c-9a98-9b3a7d8b8e62",
"enterprise_id": "4a6192a4-573d-446d-b3ce-aff9117272a6",
"phone_number": "+19493253498",
"source": "external",
"ownership_status": "verified",
"flag_reason": "carrier_changed",
"confirm_by": "2026-10-08T07:00:00Z",
"removed_at": "2026-10-09T06:02:11Z",
"removal_reason": "unconfirmed_ownership",
"reputation_data": {
"spam_risk": "low",
"spam_category": null,
"maturity_score": 72,
"connection_score": 80,
"engagement_score": 64,
"sentiment_score": 75,
"last_refreshed_at": "2026-04-26T18:09:24.785211Z"
},
"created_at": "2026-04-26T18:06:51.940749Z",
"updated_at": "2026-04-26T18:09:24.785211Z"
}
],
"meta": {
"total_pages": 3,
"total_results": 42,
"page_number": 1,
"page_size": 20
}
}