Reputation

List reputation-monitored phone numbers for an enterprise

Changed on

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.

get/enterprises/{enterprise_id}/reputation/numbers

Request

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

Path parameters

enterprise_idstring uuid required
Example:4a6192a4-573d-446d-b3ce-aff9117272a6

The enterprise id. Lowercase UUID.

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:10

Items per page. Default 10. 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[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 of numbers with reputation data.

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