Reputation

List reputation-monitored phone numbers across all enterprises

Changed on

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.

get/reputation/numbers

Request

  • Base URL: https://api.telnyx.com/v2
  • URL: https://api.telnyx.com/v2/reputation/numbers
  • Auth: HTTP bearer

Query parameters

page[number]integer
Example:1

1-based page number. Out-of-range values return an empty page with correct meta.

page[size]integer
Example:20

Items per page. Maximum 250; values above are clamped to 250.

filter[phone_number][contains]string
Example:+16035551234

Partial match on phone number. Must contain at least 5 digits.

filter[enterprise_id]string uuid

Filter by enterprise ID.

filter[phone_number][eq]string
Example:+16035551234

Exact phone-number match (E.164).

filter[source]'telnyx' | 'external'

Where the phone number is hosted. telnyx: in your Telnyx inventory. external: a number you own that is hosted with another provider.

Example:external

Only numbers with this source.

filter[ownership_status]'verified' | 'flagged' | 'pending_confirmation' | 'removed'

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.

Example:verified

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.

Response

Paginated list.

Example response

{
  "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",
        "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
  }
}

Changes

  • da303e40b51eRevision changes
    • breaking

      the ////// response's property type changed from object to no type for status

    • warning

      removed the optional property /////// from the response with the status

    • warning

      removed the optional property /////// from the response with the status

    • warning

      removed the optional property /////// from the response with the status

    • warning

      removed the optional property /////// from the response with the status

    • warning

      removed the optional property /////// from the response with the status

    • warning

      removed the optional property /////// from the response with the status

    • warning

      removed the optional property /////// from the response with the status

    • info

      added the new optional query request parameter filter[ownership_status]

    • info

      added the new optional query request parameter filter[source]

    • info

      added the optional property ////// to the response with the status

    • info

      added the optional property ////// to the response with the status

    • info

      added the optional property ////// to the response with the status

    • info

      added the optional property ////// to the response with the status

    • info

      added the optional property ////// to the response with the status

    • info

      added the optional property ////// to the response with the status

    • info

      added subschema #2 to the ////// response property anyOf list for the response status