RinghouseAPI reference
Get started

Numbers

Get a number

One number by id.

GET/v1/numbers/{number_id}

Needs the numbers:read scope.

Path parameters

number_idstringrequired
Number id

Returns

The number. A failed call answers with an error instead.

idstring
createdAtstring
emojistring
namestringnullable
phoneNumberstring
statePhoneNumberState
active | suspended | awaiting_compliance | released.
curl https://api.ringhouse.ai/v1/numbers/{number_id} \
  -H "Authorization: Bearer rh_live_xxxxxxxx"
{
  "id": "8c1d4e7a-5b2f-4a90-9e1c-3f7d2b6a1c08",
  "createdAt": "2026-09-25T14:02:11Z",
  "emoji": "…",
  "name": "Missed calls → Slack",
  "phoneNumber": "+441134960000",
  "state": "active"
}