Submit ownership proof for numbers hosted elsewhere
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.
POST
/
enterprises
/
{enterprise_id}
/
reputation
/
external_verification
JavaScript
import Telnyx from 'telnyx';
const client = new Telnyx({
apiKey: process.env['TELNYX_API_KEY'], // This is the default and can be omitted
});
const ExternalVerificationWrapped = await client.enterprises.reputation.externalVerification.create('enterprise_id', {
document_ids: ["2a7e8337-e803-4057-a4ae-26c40eb0bc6c"],
});
console.log(ExternalVerificationWrapped.data);import os
from telnyx import Telnyx
client = Telnyx(
api_key=os.environ.get("TELNYX_API_KEY"), # This is the default and can be omitted
)
external_verification_wrapped = client.enterprises.reputation.external_verification.create(
enterprise_id="enterprise_id",
document_ids=["2a7e8337-e803-4057-a4ae-26c40eb0bc6c"],
)
print(external_verification_wrapped.data)
package main
import (
"context"
"fmt"
"github.com/team-telnyx/telnyx-go"
"github.com/team-telnyx/telnyx-go/option"
)
func main() {
client := telnyx.NewClient(
option.WithAPIKey("My API Key"),
)
externalVerification, err := client.Enterprises.Reputation.ExternalVerification.New(
context.TODO(),
"enterprise_id",
telnyx.EnterpriseReputationExternalVerificationNewParams{
DocumentIds: "['2a7e8337-e803-4057-a4ae-26c40eb0bc6c']",
},
)
if err != nil {
panic(err.Error())
}
fmt.Printf("%+v\n", externalVerification.Data)
}
package com.telnyx.sdk.example;
import com.telnyx.sdk.client.TelnyxClient;
import com.telnyx.sdk.client.okhttp.TelnyxOkHttpClient;
import com.telnyx.sdk.models.enterprises.reputation.externalVerification.ExternalVerificationCreateParams;
public final class Main {
private Main() {}
public static void main(String[] args) {
TelnyxClient client = TelnyxOkHttpClient.fromEnv();
ExternalVerificationCreateParams params = ExternalVerificationCreateParams.builder()
.documentIds(["2a7e8337-e803-4057-a4ae-26c40eb0bc6c"])
.build();
var response = client.enterprises().reputation().externalVerification().create("enterprise_id", params);
}
}require "telnyx"
telnyx = Telnyx::Client.new(api_key: "My API Key")
external_verification_wrapped = telnyx.enterprises.reputation.external_verification.create("enterprise_id", document_ids: ["2a7e8337-e803-4057-a4ae-26c40eb0bc6c"])
puts(external_verification_wrapped)<?php
require_once dirname(__DIR__) . '/vendor/autoload.php';
use Telnyx\Client;
use Telnyx\Core\Exceptions\APIException;
$client = new Client(apiKey: getenv('TELNYX_API_KEY') ?: 'My API Key');
try {
$external_verification_wrapped = $client->enterprises->reputation->externalVerification->create(
'enterprise_id',
document_ids: ["2a7e8337-e803-4057-a4ae-26c40eb0bc6c"],
);
var_dump($external_verification_wrapped);
} catch (APIException $e) {
echo $e->getMessage();
}telnyx enterprises:reputation:external-verification create \
--api-key 'My API Key' \
--enterprise-id 4a6192a4-573d-446d-b3ce-aff9117272a6 \
--document-ids 2a7e8337-e803-4057-a4ae-26c40eb0bc6ccurl --request POST \
--url https://api.telnyx.com/v2/enterprises/{enterprise_id}/reputation/external_verification \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"document_ids": [
"2a7e8337-e803-4057-a4ae-26c40eb0bc6c"
]
}
'{
"data": {
"enterprise_id": "4a6192a4-573d-446d-b3ce-aff9117272a6",
"status": "pending",
"document_ids": [
"2a7e8337-e803-4057-a4ae-26c40eb0bc6c"
],
"phone_numbers": [
"+13125550142"
],
"rejection_reason": "The invoice does not show the phone numbers.",
"submitted_at": "2026-10-05T09:12:44Z",
"reviewed_at": "2026-10-06T14:03:10Z"
}
}Authorizations
Telnyx API key. Generate one at https://portal.telnyx.com/#/app/api-keys.
Path Parameters
Body
application/json
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.
Required array length:
1 - 10 elementsRequired string length:
1 - 255Example:
["2a7e8337-e803-4057-a4ae-26c40eb0bc6c"]
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.
Maximum array length:
1000Example:
["+13125550142"]
Was this page helpful?
JavaScript
import Telnyx from 'telnyx';
const client = new Telnyx({
apiKey: process.env['TELNYX_API_KEY'], // This is the default and can be omitted
});
const ExternalVerificationWrapped = await client.enterprises.reputation.externalVerification.create('enterprise_id', {
document_ids: ["2a7e8337-e803-4057-a4ae-26c40eb0bc6c"],
});
console.log(ExternalVerificationWrapped.data);import os
from telnyx import Telnyx
client = Telnyx(
api_key=os.environ.get("TELNYX_API_KEY"), # This is the default and can be omitted
)
external_verification_wrapped = client.enterprises.reputation.external_verification.create(
enterprise_id="enterprise_id",
document_ids=["2a7e8337-e803-4057-a4ae-26c40eb0bc6c"],
)
print(external_verification_wrapped.data)
package main
import (
"context"
"fmt"
"github.com/team-telnyx/telnyx-go"
"github.com/team-telnyx/telnyx-go/option"
)
func main() {
client := telnyx.NewClient(
option.WithAPIKey("My API Key"),
)
externalVerification, err := client.Enterprises.Reputation.ExternalVerification.New(
context.TODO(),
"enterprise_id",
telnyx.EnterpriseReputationExternalVerificationNewParams{
DocumentIds: "['2a7e8337-e803-4057-a4ae-26c40eb0bc6c']",
},
)
if err != nil {
panic(err.Error())
}
fmt.Printf("%+v\n", externalVerification.Data)
}
package com.telnyx.sdk.example;
import com.telnyx.sdk.client.TelnyxClient;
import com.telnyx.sdk.client.okhttp.TelnyxOkHttpClient;
import com.telnyx.sdk.models.enterprises.reputation.externalVerification.ExternalVerificationCreateParams;
public final class Main {
private Main() {}
public static void main(String[] args) {
TelnyxClient client = TelnyxOkHttpClient.fromEnv();
ExternalVerificationCreateParams params = ExternalVerificationCreateParams.builder()
.documentIds(["2a7e8337-e803-4057-a4ae-26c40eb0bc6c"])
.build();
var response = client.enterprises().reputation().externalVerification().create("enterprise_id", params);
}
}require "telnyx"
telnyx = Telnyx::Client.new(api_key: "My API Key")
external_verification_wrapped = telnyx.enterprises.reputation.external_verification.create("enterprise_id", document_ids: ["2a7e8337-e803-4057-a4ae-26c40eb0bc6c"])
puts(external_verification_wrapped)<?php
require_once dirname(__DIR__) . '/vendor/autoload.php';
use Telnyx\Client;
use Telnyx\Core\Exceptions\APIException;
$client = new Client(apiKey: getenv('TELNYX_API_KEY') ?: 'My API Key');
try {
$external_verification_wrapped = $client->enterprises->reputation->externalVerification->create(
'enterprise_id',
document_ids: ["2a7e8337-e803-4057-a4ae-26c40eb0bc6c"],
);
var_dump($external_verification_wrapped);
} catch (APIException $e) {
echo $e->getMessage();
}telnyx enterprises:reputation:external-verification create \
--api-key 'My API Key' \
--enterprise-id 4a6192a4-573d-446d-b3ce-aff9117272a6 \
--document-ids 2a7e8337-e803-4057-a4ae-26c40eb0bc6ccurl --request POST \
--url https://api.telnyx.com/v2/enterprises/{enterprise_id}/reputation/external_verification \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"document_ids": [
"2a7e8337-e803-4057-a4ae-26c40eb0bc6c"
]
}
'{
"data": {
"enterprise_id": "4a6192a4-573d-446d-b3ce-aff9117272a6",
"status": "pending",
"document_ids": [
"2a7e8337-e803-4057-a4ae-26c40eb0bc6c"
],
"phone_numbers": [
"+13125550142"
],
"rejection_reason": "The invoice does not show the phone numbers.",
"submitted_at": "2026-10-05T09:12:44Z",
"reviewed_at": "2026-10-06T14:03:10Z"
}
}