Reputation

Enable phone-number reputation for an enterprise

Changed on

Activate Phone Number Reputation for the given enterprise. Requires an uploaded Letter of Authorization document (the loa_document_id references the Telnyx Documents API) and a refresh-frequency selection. After activation, individual phone numbers can be registered via POST .../reputation/numbers.

Prerequisite: the calling user must have agreed to the Phone Number Reputation Terms of Service (POST /terms_of_service/number_reputation/agree).

Failure modes:

  • 403 - Phone Number Reputation Terms of Service not accepted.
  • 404 - enterprise does not exist or does not belong to your account.
  • 400 - reputation already enabled for this enterprise.
  • 422 - loa_document_id missing or check_frequency invalid.

Pricing: This is a billable action. See https://telnyx.com/pricing/numbers for current pricing.

post/enterprises/{enterprise_id}/reputation

Request

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

Path parameters

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

The enterprise id. Lowercase UUID.

Request body

loa_document_idstring required

Id of the signed Letter of Authorization document, returned by the Telnyx Documents API after upload (upload via POST /v2/documents; see https://developers.telnyx.com/api/documents).

check_frequency'business_daily' | 'daily' | 'weekly' | 'biweekly' | 'monthly' | 'never'

How often Telnyx refreshes the stored reputation data for this enterprise's registered numbers.

Example request

{
  "loa_document_id": "2a7e8337-e803-4057-a4ae-26c40eb0bc6c"
}

Response

Reputation enabled.

Example response

{
  "data": {
    "enterprise_id": "4a6192a4-573d-446d-b3ce-aff9117272a6",
    "loa_document_id": "2a7e8337-e803-4057-a4ae-26c40eb0bc6c",
    "loa_status": "pending",
    "external_verification_status": "pending",
    "webhook_url": "https://example.com/webhooks/telnyx",
    "created_at": "2026-04-26T18:06:51.940749Z",
    "updated_at": "2026-04-26T18:09:24.785211Z"
  }
}

Changes

  • a72569d69430Revision changes
    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

  • 8a8c40f458c5Revision changes
    • breaking

      added to the request property allOf list

    • breaking

      removed the enum value biweekly of the request property

    • breaking

      removed the enum value business_daily of the request property

    • breaking

      removed the enum value daily of the request property

    • breaking

      removed the enum value monthly of the request property

    • breaking

      removed the enum value never of the request property

    • breaking

      removed the enum value weekly of the request property

    • breaking

      the request property type changed from string to no type

    • info

      api operation id EnableReputationSettings removed and replaced with enableReputationSettings

    • info

      api tag Reputation added

    • info

      api tag Number Reputation Settings removed

    • info

      removed the non-success 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 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 the optional property /// to the response with the status

    • info

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

    • info

      the response optional property / became read-only for the status

    • info

      the response optional property / became read-only for the status

    • info

      the response property became required for the status

    • info

      the response property became required for the status

    • info

      the response property became required for the status

    • info

      the response property became required for the status

    • info

      the response property // became required for the status

    • info

      the response property // became required for the status

    • info

      the response property // became required for the status

    • info

      the response property // became required for the status

    • info

      the response property // became required for the status

    • info

      the response property // became required for the status

    • info

      the response property /// became required for the status

    • info

      the response property /// became required for the status

    • info

      the response property /// became required for the status