> ## Documentation Index
> Fetch the complete documentation index at: https://docs.orbit.devotel.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Number Health & Reputation

> Per-number warming, deliverability health, carrier reputation, usage analytics, and branded-calling uplift

# 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.

```bash theme={null}
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:

```bash theme={null}
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.

```bash theme={null}
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.

```bash theme={null}
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](/numbers/cnam) for spam-label remediation.

## Usage Analytics

Per-number usage rollup over a configurable window.

```bash theme={null}
curl "https://api.orbit.devotel.io/api/v1/numbers/num_abc123/usage-analytics?window=30d" \
  -H "X-API-Key: dv_live_sk_..."
```

| Parameter | Values                          | Default | Description    |
| --------- | ------------------------------- | ------- | -------------- |
| `window`  | `24h` \| `7d` \| `30d` \| `90d` | `30d`   | Rollup 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.

```bash theme={null}
curl "https://api.orbit.devotel.io/api/v1/numbers/num_abc123/branded-calling-analytics" \
  -H "X-API-Key: dv_live_sk_..."
```