​

Telnyx Numbers: Number Reputation — Documentation Index

Number Reputation documentation within the Numbers section of the Telnyx developer docs (https://developers.telnyx.com). Root index: https://developers.telnyx.com/llms.txt · Numbers index: https://developers.telnyx.com/development/llms/numbers-llms-txt.md · Full content for this subsection: https://developers.telnyx.com/development/llms/numbers-number-reputation-llms-full-txt.md

• Overview: Monitor the spam reputation of your outbound calling phone numbers with Telnyx Number Reputation.
• Quickstart: Step-by-step guide to set up Number Reputation and start monitoring your phone numbers’ spam scores.
• Pricing: Number Reputation pricing — enterprise monitoring, per-check reputation queries, and per-check remediation.
• Letter of Authorization: Render, sign, upload, and manage the Letter of Authorization that Telnyx needs before activating Number Reputation.
• Reputation Settings: Enable, configure, and manage Number Reputation monitoring for your enterprise.
• Phone Numbers: Associate phone numbers for monitoring, query spam scores and risk levels, and manage ongoing reputation tracking.
• Remediation: Submit spam-flagged phone numbers for re-evaluation, then poll the request to track per-number remediation results.

​

API Reference (Number Reputation)

​

Enterprises

• List enterprises: Return the enterprises you own, paginated. The default page size is 20; the maximum is 250.
• Create an enterprise: Create the legal entity (enterprise) that represents your business on the Telnyx platform.
• Get an enterprise: Retrieve a single enterprise by id. Returns 404 if the id does not exist or does not belong to your account.
• Replace an enterprise: Replace the enterprise’s mutable fields. Only mutable fields may be sent. Server-assigned and immutable fields (id, record_type, created_at, updated_at…
• Delete an enterprise: Soft-delete an enterprise.

​

Terms of Service

• Agree to the Phone Number Reputation Terms of Service: Records the authenticated user’s agreement to the current Phone Number Reputation ToS. No body required. Idempotent.

​

Reputation

• Get phone-number reputation settings for an enterprise: Phone Number Reputation tracks how your outbound caller-IDs are perceived (spam risk, engagement, etc.) across the call-screening ecosystem. This endpoint read…
• Enable phone-number reputation for an enterprise: Activate Phone Number Reputation for the given enterprise. Requires an uploaded Letter of Authorization document (the loa_document_id references the Telnyx D…
• Disable phone-number reputation for an enterprise: Disable Phone Number Reputation. All registered numbers are de-registered as a cascade. The enterprise itself is unaffected. Returns 204 on success, 404 if…
• Change the reputation refresh frequency: Update how often Telnyx refreshes the reputation data for this enterprise’s registered numbers. The new frequency takes effect on the next scheduled refresh.
• Render a phone-number reputation Letter of Authorization: Render the LOA for this enterprise as a PDF. The enterprise identity, address, and authorized-representative contact are taken from the enterprise record; the…
• Replace the reputation Letter of Authorization document: Point the enterprise’s reputation settings at a new signed LOA document. This resets LOA approval to pending; the new document must be approved before additi…
• List reputation-monitored phone numbers for an enterprise: Paginated list of phone numbers registered for reputation monitoring under this enterprise. The response includes the latest reputation snapshot per number whe…
• 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 phon…
• Get a single reputation-monitored phone number: Retrieve one registered number with its latest reputation snapshot. The phone_number path parameter is in E.164 format and must be URL-encoded (e.g. `%2B1949…
• Remove a phone number from reputation monitoring: Stop tracking the reputation of this phone number. The number itself remains in your inventory; only the reputation registration is removed.
• List reputation-monitored phone numbers across all enterprises: Convenience alias for GET /v2/enterprises/{enterprise_id}/reputation/numbers that returns numbers across every enterprise you own. Useful when you don’t want…
• Get a reputation-monitored number (no enterprise_id required): Convenience alias for GET /v2/enterprises/{enterprise_id}/reputation/numbers/{phone_number}.
• Remove a phone number from reputation monitoring (no enterprise_id required): Convenience alias for DELETE /v2/enterprises/{enterprise_id}/reputation/numbers/{phone_number}.
• List reputation remediation requests for an enterprise: Paginated list of remediation requests for this enterprise. List items omit per-number results and webhook URLs to keep the response small; call GET by id for…
• Submit phone numbers for reputation remediation: Submit a batch of phone numbers belonging to this enterprise for reputation remediation. The request is accepted asynchronously: this endpoint returns 202 wi…
• Get a reputation remediation request: Retrieve the full detail of a remediation request, including current status, per-number results (once available), and submission metadata.