---
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`

## Request

- Base URL: `https://api.telnyx.com/v2`
- URL: `https://api.telnyx.com/v2/enterprises/{enterprise_id}/reputation/numbers/refresh`
- Auth: HTTP bearer

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.

## Changes

- **2026-06-05** `8a8c40f458c5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/team-telnyx/apis/telnyx-api/changes/enterprises/:enterprise_id/reputation/numbers/refresh/post.md)

---

[API](https://skmtc.dev/team-telnyx/apis/telnyx-api.md) - [All operations](https://skmtc.dev/team-telnyx/apis/telnyx-api/llms.txt) - [OpenAPI document](https://skmtc.dev/team-telnyx/apis/telnyx-api/revisions/0f17b8167873?raw)