---
title: "Force a reputation refresh"
method: POST
path: "/enterprises/{enterprise_id}/reputation/numbers/refresh"
tags: ["Reputation"]
---

# Force a reputation refresh

`POST /enterprises/{enterprise_id}/reputation/numbers/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.

## Path parameters

- `enterprise_id` string, uuid, required

## Request body

- RefreshReputationRequest
  - `phone_numbers` string[], 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.

## Response `200`

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

- RefreshReputationResponse
  - `data` object, required
    - `results` object[], required — Per-number outcome of the refresh.
      - `phone_number` string, required
      - `success` boolean, required
      - `error` string, nullable — `null` when `success` is `true`; carries an error message otherwise.
    - `total_requested` integer, required
    - `total_successful` integer, required
    - `total_failed` integer, required

## Other responses

- `default` — An error occurred. The response carries the standard Telnyx error envelope.
- `4XX` — An error occurred. The response carries the standard Telnyx error envelope.

---

[API](https://skmtc.net/team-telnyx/apis/telnyx-api.md) · [All operations](https://skmtc.net/team-telnyx/apis/telnyx-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api/versions/e32d46c5945b/schema)