Skip to main content

​
Overview

Number Reputation Settings control the monitoring lifecycle for your enterprise. You enable reputation monitoring, configure how often numbers are checked, and manage the vetting status.

​
Prerequisites

Before enabling Number Reputation, you need:
  1. An Enterprise registered on your account
  2. A signed Letter of Authorization (LOA) uploaded via the Documents API — this authorizes Telnyx to register your numbers with third-party analytics providers

​
Enable Number Reputation

Submit your LOA document ID to enable reputation monitoring: 
curl -X POST https://api.telnyx.com/v2/enterprises/{enterprise_id}/reputation \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "loa_document_id": "YOUR_DOCUMENT_ID"
  }'
Your enterprise details are sent to Hiya for automated vetting. This typically takes minutes.

​
Vetting lifecycle

pending ──► approved    (you can now register numbers and query reputation)
pending ──► rejected    (check rejection_reasons in the response)
approved ──► deleted    (reputation disabled via DELETE)
Check your current status: 
curl https://api.telnyx.com/v2/enterprises/{enterprise_id}/reputation \
  -H "Authorization: Bearer YOUR_API_KEY"
The response includes:
FieldDescription
statuspending, approved, rejected, or deleted
check_frequencyCurrent auto-refresh schedule
loa_document_idYour uploaded LOA reference
rejection_reasonsArray of reasons if status is rejected

​
Auto-refresh schedules

Telnyx automatically runs fresh reputation queries on all your registered numbers based on the configured check_frequency:
FrequencySchedule
business_dailyMon–Fri (default)
dailyEvery day including weekends
weeklyOnce per week
biweeklyEvery 2 weeks
monthlyOnce per month
neverManual only — use ?fresh=true or bulk refresh

​
Change the schedule

curl -X PATCH https://api.telnyx.com/v2/enterprises/{enterprise_id}/reputation/frequency \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"check_frequency": "daily"}'
Choose a frequency that balances data freshness with cost. Each auto-refresh counts as a billed query per number.

​
Disable Number Reputation

To stop monitoring entirely and remove the enterprise from reputation tracking: 
curl -X DELETE https://api.telnyx.com/v2/enterprises/{enterprise_id}/reputation \
  -H "Authorization: Bearer YOUR_API_KEY"
This de-registers your numbers from analytics providers. The status changes to deleted.

​
Terms of Service

You must accept the Number Reputation Terms of Service before enabling monitoring: 
curl -X POST https://api.telnyx.com/v2/terms_of_service/number_reputation/agree \
  -H "Authorization: Bearer YOUR_API_KEY"
This is a one-time step per account.