Reputation

Confirm or give up ownership of a phone number

Changed on

Answer an ownership question about a phone number hosted with another provider.

Send still_own: true to confirm you still own a number whose ownership_status is pending_confirmation or flagged; its status returns to verified and, after a carrier change, the new carrier becomes the one on record.

Send still_own: false to report that you no longer own the number. It is removed from Number Reputation immediately, whatever its current status, and the response shows it with ownership_status: removed.

post/enterprises/{enterprise_id}/reputation/numbers/{phone_number}/ownership_confirm

Request

  • Base URL: https://api.telnyx.com/v2
  • URL: https://api.telnyx.com/v2/enterprises/{enterprise_id}/reputation/numbers/{phone_number}/ownership_confirm
  • 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).

Request body

still_ownboolean required

true confirms you still own the number. false reports that you no longer own it and removes it from Number Reputation.

evidence_document_idstring

Optional id of an uploaded document supporting the confirmation.

Example request

{
  "still_own": true,
  "evidence_document_id": "2a7e8337-e803-4057-a4ae-26c40eb0bc6c"
}

Response

The phone number after the confirmation, or the removed number.

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

Changes