RinghouseAPI reference
Get started

Numbers

List numbers

List the workspace's numbers, newest first.

GET/v1/numbers

Needs the numbers:read scope.

Query parameters

limitinteger
1–100, default 25.
cursorstring
The `nextCursor` from a previous response.

Returns

A page of numbers. The items are in data, and nextCursor fetches the next page. 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 \
  -H "Authorization: Bearer rh_live_xxxxxxxx"
{
  "data": [
    {
      "id": "4b1a8d2e-6c3f-47b9-8e05-d91a2c7f6b34",
      "createdAt": "2026-09-25T14:02:11Z",
      "emoji": "…",
      "name": "Missed calls → Slack",
      "phoneNumber": "+441134960000",
      "state": "active"
    }
  ],
  "nextCursor": "MjAyNi0wOS0yNVQxNDowMjoxMVp8M2Y5YzFhMmU"
}
Was this page helpful?
Previous← Get a contactNextGet a number