v52

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

Reputation

Force a reputation refresh

Immediately refresh the stored reputation data for the listed numbers. This is in addition to the periodic refresh determined by check_frequency. Up to 100 numbers per call. The response carries the kicked-off jobs; the actual refresh runs asynchronously.

Pricing: Forcing a refresh performs live reputation lookups, which are billable. See https://telnyx.com/pricing/numbers for current pricing.

post/enterprises/{enterprise_id}/reputation/numbers/refresh

Path parameters

enterprise_idstring uuid required

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

The enterprise id. Lowercase UUID.

Request body

phone_numbersstring[] required

Phone numbers to refresh reputation data for. 1–100 numbers per request, each in E.164 format. Reputation refreshes are subject to per-enterprise rate limits.

Example request

{
  "phone_numbers": [
    "+19493253498"
  ]
}

Response

Refresh completed (the call is synchronous from the customer's POV - Telnyx fans out to the reputation feed before responding).

Example response

{
  "data": {
    "results": [
      {
        "phone_number": "+19493253498",
        "success": true
      }
    ],
    "total_requested": 1,
    "total_successful": 1
  }
}