---
title: "Submit ownership proof for numbers hosted elsewhere"
method: POST
path: "/enterprises/{enterprise_id}/reputation/external_verification"
tags: ["Reputation"]
---

# Submit ownership proof for numbers hosted elsewhere

`POST /enterprises/{enterprise_id}/reputation/external_verification`

## Request

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

Request permission to add phone numbers that the enterprise owns but that are hosted with another provider. Submit one or more uploaded documents proving ownership, such as a carrier invoice or account statement. The request is reviewed once per enterprise. While it is `pending` or `rejected` you can submit again to replace the documents; once `approved` it cannot be changed.

## Path parameters

- `enterprise_id` string, uuid, required

## Request body

- ExternalVerificationSubmit
  - `document_ids` string[], required: Ids of uploaded documents (Documents API) proving the enterprise owns its phone numbers hosted with another provider, for example a carrier invoice or account statement.
  - `phone_numbers` string[]: Optional. The phone numbers hosted with another provider that the documents cover, in E.164 format. Shown to the reviewer to match the documents to your numbers; you can still add numbers that are not listed here, and each is checked on its own.

## Response `201`

The ownership proof was submitted for review.

- ExternalVerificationWrapped
  - `data` ExternalVerification, required
    - `enterprise_id` string, uuid
    - `status` 'pending' | 'approved' | 'rejected': Review state of the ownership proof that allows adding phone numbers hosted with another provider.
    - `document_ids` string[]: The ownership-proof documents on file.
    - `phone_numbers` string[]: The phone numbers you listed with the documents.
    - `rejection_reason` string, nullable: Why the proof was rejected. Set only when `status` is `rejected`.
    - `submitted_at` string, date-time, nullable
    - `reviewed_at` string, date-time, nullable

## Other responses

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

## Changes

> 152 revisions in range; 1 not diffed.

- **2026-10-15** `da303e40b51e`: 1 info
  - endpoint added

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

---

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