v52

OpenAPI 3.1.0raw.githubusercontent.com2026-07-311,1941,9384.1 MB

Reputation

Enable phone-number reputation for an enterprise

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

Path parameters

enterprise_idstring uuid required

Example:4a6192a4-573d-446d-b3ce-aff9117272a6

The enterprise id. Lowercase UUID.

Request body

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

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).

Example request

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

Response

Reputation enabled.

Example response

{
  "data": {
    "created_at": "2026-04-26T18:06:51.940749Z",
    "enterprise_id": "4a6192a4-573d-446d-b3ce-aff9117272a6",
    "loa_document_id": "2a7e8337-e803-4057-a4ae-26c40eb0bc6c",
    "loa_status": "pending",
    "updated_at": "2026-04-26T18:09:24.785211Z"
  }
}