Reputation

Get a phone number's ownership tracking detail

Changed on

Get the ownership status of a phone number, when it was last checked, the carrier recorded as its baseline, and the history of ownership events.

get/enterprises/{enterprise_id}/reputation/numbers/{phone_number}/ownership

Request

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

Path parameters

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

The enterprise id. Lowercase UUID.

phone_numberstring required
Example:+19493253498

Phone number in E.164 format (+1NPANXXXXXX for US/CA). The leading + MUST be URL-encoded as %2B (e.g. %2B19493253498).

Response

Ownership tracking detail.

Example response

{
  "data": {
    "phone_number": "+19493253498",
    "source": "external",
    "ownership_status": "verified",
    "last_checked_at": "2026-10-05T06:00:41Z",
    "baseline_carrier": "114J",
    "baseline_recorded_at": "2026-09-20T15:22:09Z",
    "history": [
      {
        "event_type": "check",
        "outcome": "unchanged",
        "occurred_at": "2026-10-05T06:00:41Z"
      }
    ]
  }
}

Changes