v52

OpenAPI 3.1.0raw.githubusercontent.com2026-07-311,1941,9384.1 MB

Reputation

Register phone numbers for reputation monitoring

Add up to 100 phone numbers to reputation monitoring on this enterprise. Each must be in E.164 format (+1NPANXXXXXX for US/CA) and belong to your Telnyx phone-number inventory.

Prerequisite: reputation must already be enabled on this enterprise (see POST .../reputation).

Pricing: This is a billable action. See https://telnyx.com/pricing/numbers for current pricing.

post/enterprises/{enterprise_id}/reputation/numbers

Path parameters

enterprise_idstring uuid required

Example:4a6192a4-573d-446d-b3ce-aff9117272a6

The enterprise id. Lowercase UUID.

Request body

phone_numbersstring[] required

1–100 phone numbers in E.164 format with a leading +.

Example request

{
  "phone_numbers": [
    "+19493253498"
  ]
}

Response

Numbers registered.

Example response

{
  "data": [
    {
      "created_at": "2026-04-26T18:06:51.940749Z",
      "enterprise_id": "4a6192a4-573d-446d-b3ce-aff9117272a6",
      "id": "8a4b1f5e-2f12-4c0c-9a98-9b3a7d8b8e62",
      "phone_number": "+19493253498",
      "reputation_data": {
        "connection_score": 80,
        "engagement_score": 64,
        "last_refreshed_at": "2026-04-26T18:09:24.785211Z",
        "maturity_score": 72,
        "sentiment_score": 75,
        "spam_risk": "low"
      },
      "updated_at": "2026-04-26T18:09:24.785211Z"
    }
  ],
  "meta": {
    "page_number": 1,
    "page_size": 20,
    "total_pages": 3,
    "total_results": 42
  }
}