Skip to main content
GET
Retrieve a monitored number

Authorizations

Authorization
string
header
required

OptimalDial API key, prefixed od_live_, sent as Authorization: Bearer .... Mint keys in the in-app developer panel; they are scoped to a single organization.

Path Parameters

number_id
string<uuid>
required

Response

The number and its latest per-carrier status.

id
string<uuid>
required
phone_number
string
required

E.164-normalized phone number (US/CA only).

Example:

"+15551234567"

verified
boolean
required

Whether the number has completed verification. Monitoring only runs for verified numbers.

same_carrier_warning
boolean
required

true when a test was run from the same carrier as the monitored number, which can skew the spam result. Treat such results with care.

status
enum<string>
required
Available options:
active,
paused
created_at
string<date-time>
required
carrier_statuses
object[]
required

Latest status for each carrier OptimalDial tests against.

carrier
string | null

The number's own carrier, when known. Used to flag same-carrier tests.

updated_at
string<date-time> | null