Telnyx

import Telnyx from 'telnyx'; const client = new Telnyx({ apiKey: process.env['TELNYX_API_KEY'], // This is the default and can be omitted }); const number = await client.enterprises.reputation.numbers.retrieve('+19493253498', { enterprise_id: '4a6192a4-573d-446d-b3ce-aff9117272a6', }); console.log(number.data);

{ "data": { "id": "8a4b1f5e-2f12-4c0c-9a98-9b3a7d8b8e62", "enterprise_id": "4a6192a4-573d-446d-b3ce-aff9117272a6", "phone_number": "+19493253498", "reputation_data": { "spam_risk": "low", "spam_category": null, "maturity_score": 72, "connection_score": 80, "engagement_score": 64, "sentiment_score": 75, "last_refreshed_at": "2026-04-26T18:09:24.785211Z" }, "created_at": "2026-04-26T18:06:51.940749Z", "updated_at": "2026-04-26T18:09:24.785211Z" } }

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

enterprise_id

string<uuid>

required

The enterprise id. Lowercase UUID.

Example:

"4a6192a4-573d-446d-b3ce-aff9117272a6"

phone_number

string

required

Phone number in E.164 format (+1NPANXXXXXX for US/CA). The leading + MUST be URL-encoded as %2B (e.g. %2B19493253498).

Example:

"+19493253498"

Query Parameters

fresh

boolean

default:false

When true, fetches fresh reputation data (incurs API cost). When false (default), returns cached data.

Response

Phone number with reputation data.

data

object

required

Show child attributes