Reputation

Submit ownership proof for numbers hosted elsewhere

Changed on

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

Request

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

Path parameters

enterprise_idstring uuid required
Example:4a6192a4-573d-446d-b3ce-aff9117272a6

The enterprise id. Lowercase UUID.

Request body

document_idsstring[] 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_numbersstring[]

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.

Example request

{
  "document_ids": [
    "2a7e8337-e803-4057-a4ae-26c40eb0bc6c"
  ],
  "phone_numbers": [
    "+13125550142"
  ]
}

Response

The ownership proof was submitted for review.

Example response

{
  "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"
  }
}

Changes