---
title: "List reputation-monitored phone numbers for an enterprise"
method: GET
path: "/enterprises/{enterprise_id}/reputation/numbers"
tags: ["Reputation"]
---

# List reputation-monitored phone numbers for an enterprise

`GET /enterprises/{enterprise_id}/reputation/numbers`

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.

## Path parameters

- `enterprise_id` string, uuid, required

## Query parameters

- `page[number]` integer
- `page[size]` integer
- `filter[phone_number][contains]` string
- `filter[phone_number][eq]` string

## Response `200`

Paginated list of numbers with reputation data.

- ReputationPhoneNumberListWithReputation
  - `data` ReputationPhoneNumber[], required
    - `id` string, uuid
    - `enterprise_id` string, uuid
    - `phone_number` string — E.164 with leading `+`.
    - `reputation_data` ReputationData — Reputation snapshot for a phone number. Each metric is a 0–100 score; `spam_risk` is a coarse bucket. Field set may grow over time - read by key.
      - `spam_risk` 'low' | 'medium' | 'high', nullable — Overall spam-risk classification.
      - `spam_category` string, nullable — Category label from the reputation feed when the number is flagged.
      - `maturity_score` integer, nullable
      - `connection_score` integer, nullable
      - `engagement_score` integer, nullable
      - `sentiment_score` integer, nullable
      - `last_refreshed_at` string, date-time, nullable
    - `created_at` string, date-time
    - `updated_at` string, date-time
  - `meta` NumberReputationPaginationMeta, required — JSON:API pagination metadata returned with every paginated list response. Page numbering is 1-based. `page_size` reports the number of items actually returned in `data` for this page; the requested size is taken from the `page[size]` query parameter.
    - `total_pages` integer, required — Total number of pages available given the current `page_size`.
    - `total_results` integer, required — Total number of items across all pages (excludes soft-deleted rows).
    - `page_number` integer, required — 1-based index of this page. Echoes the `page[number]` query parameter (default `1`).
    - `page_size` integer, required — Number of items returned in this page's `data` array. Capped at 250.

## Other responses

- `401` — An error occurred. The response carries the standard Telnyx error envelope.
- `404` — An error occurred. The response carries the standard Telnyx error envelope.

---

[API](https://skmtc.net/team-telnyx/apis/telnyx-api.md) · [All operations](https://skmtc.net/team-telnyx/apis/telnyx-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api/revisions/e32d46c5945b/schema)