Skip to main content
GET
Get Workspace Numbers
List phone numbers available in the workspace. Outbound calls and campaigns use these numbers as caller IDs. Inbound assistants use assigned numbers as the numbers users dial.

When to use

  • Populate a caller-number selector before starting calls.
  • Find the from_number_id for POST /calling/outbound/individual.
  • Confirm imported BYOT numbers are available after telephony setup.

Integration notes

  • Store the selected from_number_id alongside your assistant or campaign configuration.
  • Numbers must be provisioned, imported, or assigned in the Ringg workspace before they can be used.
  • For campaigns, pass selected numbers in from_numbers.

Headers

X-API-KEY
string
required

(Required) Your Ringg AI API key.

Example:

"7251cb4b-3373-43a4-844c-b27a1d45e0c9"

Query Parameters

limit
integer
default:10

Number of items to return (default: 20, max: 100).

Example:

50

offset
integer
default:0

Number of items to skip (default: 0).

Example:

20

Response

Successful Response: A list of available phone numbers.

workspace_numbers
object[]