---
title: "Get a reputation remediation request"
method: GET
path: "/enterprises/{enterprise_id}/reputation/remediation/{remediation_id}"
tags: ["Reputation"]
---

# Get a reputation remediation request

`GET /enterprises/{enterprise_id}/reputation/remediation/{remediation_id}`

## Request

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

Retrieve the full detail of a remediation request, including current status, per-number results (once available), and submission metadata.

## Path parameters

- `enterprise_id` string, uuid, required
- `remediation_id` string, uuid, required

## Response `200`

The remediation request.

- RemediationRequestWrapped
  - `data` RemediationRequest, required: Full detail of a remediation request, returned on submit and GET by id.
    - `id` string, uuid, required
    - `status` 'pending' | 'in_progress' | 'completed' | 'failed' | 'cancelled', required: Customer-facing status of a remediation request.
    - `phone_numbers_count` integer, required: Total phone numbers in this batch, including any later cancelled. May exceed the sum of the per-category result buckets, which omit cancelled numbers.
    - `phone_numbers_submitted` integer, required: Numbers accepted for remediation, i.e. not rejected as ineligible. Counts numbers still queued (pending) as well as processed ones.
    - `phone_numbers_ineligible` integer, required: Numbers rejected before submission (e.g. cooldown).
    - `call_purpose` string, required
    - `contact_email` string, email, nullable
    - `webhook_url` string, uri, nullable
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `tier1_completed_at` string, date-time, nullable
    - `tier2_completed_at` string, date-time, nullable
    - `results` RemediationPerNumberResults: Per-category buckets of phone numbers, populated once results are available. Empty lists are kept (not omitted) so consumers can iterate without null-checking each key.
      - `remediated` string[]
      - `not_flagged` string[]
      - `requires_review` string[]
      - `ineligible` string[]
      - `refused` string[]

## Other responses

- `401`: An error occurred. The response carries the standard Telnyx error envelope.
- `404`: An error occurred. The response carries the standard Telnyx error envelope.

## Changes

- **2026-10-15** `a72569d69430`: 1 breaking, 5 warning, 1 info
  - the `data/results` response's property type changed from `object` to no type for status `200`
  - removed the optional property `data/results/ineligible` from the response with the `200` status
  - removed the optional property `data/results/not_flagged` from the response with the `200` status
  - removed the optional property `data/results/refused` from the response with the `200` status
  - …3 more
- **2026-06-11** `81ee1b2477a2`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/team-telnyx/apis/telnyx-api/changes/enterprises/:enterprise_id/reputation/remediation/:remediation_id/get.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)