---
title: "List reputation-monitored phone numbers across all enterprises"
method: GET
path: "/reputation/numbers"
tags: ["Reputation"]
---

# List reputation-monitored phone numbers across all enterprises

`GET /reputation/numbers`

Convenience alias for `GET /v2/enterprises/{enterprise_id}/reputation/numbers` that returns numbers across every enterprise you own. Useful when you don't want to look up the enterprise id first.

## Query parameters

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

## Response `200`

Paginated list.

- 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.

## Changes

- **2026-06-11** `81ee1b2477a2` — 1 warning, 3 info
  - deleted the `query` request parameter `phone_number`
  - added the new optional `query` request parameter `filter[enterprise_id]`
  - added the new optional `query` request parameter `filter[phone_number][contains]`
  - added the new optional `query` request parameter `filter[phone_number][eq]`
- **2026-06-05** `8a8c40f458c5` — 2 breaking, 2 warning, 13 info
  - for the `query` request parameter `page[size]`, default value was changed from `10` to `20`
  - the response's body type/format changed from `object`/`` to ``/`` for status `200`
  - removed the optional property `data` from the response with the `200` status
  - removed the optional property `meta` from the response with the `200` status
  - …13 more

[Change history](https://skmtc.dev/team-telnyx/apis/telnyx-api/changes/reputation/numbers/get.md)

---

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