Skip to main content

​
Number Health & Reputation

Monitor the operational health of each number: its 10DLC warming ramp, deliverability health score, carrier-displayed reputation, usage rollups, and branded-calling answer-rate uplift. Every endpoint is a pure read of locally-persisted snapshots — no live carrier call, no outbound voice/SMS path.

​
Warming

Per-number 10DLC warming-tier state, so a warming-progress card can render the ramp meter. 
curl "https://api.orbit.devotel.io/api/v1/numbers/num_abc123/warming" \
  -H "X-API-Key: dv_live_sk_..."
Returns the current daily_cap, live current_day_count, warming_phase (initial | ramp | steady | verified), trust_score, and warming_started_at. Returns null for non-10DLC numbers. For the growth-curve forecast: 
curl "https://api.orbit.devotel.io/api/v1/numbers/num_abc123/warming/progression" \
  -H "X-API-Key: dv_live_sk_..."
Returns the warming_state + warming_started_at + warming_max_daily_sms columns plus a 15-day forecast.

​
Health (deliverability)

The latest deliverability health snapshot — delivery rate and complaint rate — from the daily health-score scheduler. 
curl "https://api.orbit.devotel.io/api/v1/numbers/num_abc123/health" \
  -H "X-API-Key: dv_live_sk_..."
This scores internal deliverability (complaint-coded message error codes). For the carrier-displayed spam label, use Reputation below.

​
Reputation

Per-number carrier spam-label reputation — how Hiya / TNS / First Orion / Free Caller Registry / Nomorobo label your own outbound number — plus a registration/dispute remediation plan to clear a false “Spam Likely” / “Scam Likely” tag. 
curl "https://api.orbit.devotel.io/api/v1/numbers/num_abc123/reputation" \
  -H "X-API-Key: dv_live_sk_..."
Returns monitored: false / status: "unknown" until the probe scheduler covers the number. See CNAM & Caller ID for spam-label remediation.

​
Usage Analytics

Per-number usage rollup over a configurable window. 
curl "https://api.orbit.devotel.io/api/v1/numbers/num_abc123/usage-analytics?window=30d" \
  -H "X-API-Key: dv_live_sk_..."
ParameterValuesDefaultDescription
window24h | 7d | 30d | 90d30dRollup window.
Returns call + message counts, durations, and delivery outcomes scoped to the number and window.

​
Branded-Calling Analytics

Per-number Rich Call Data (RCD) answer-rate uplift: compares the number’s outbound answer rate for the requested window against the immediately-preceding equal-length baseline, alongside your organization’s branded-calling status — so a customer who registered a brand profile can see the contact-center answer-rate lift. 
curl "https://api.orbit.devotel.io/api/v1/numbers/num_abc123/branded-calling-analytics" \
  -H "X-API-Key: dv_live_sk_..."