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

# Get Workspace Numbers

> Retrieves a list of available phone numbers in your workspace.

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


## OpenAPI

````yaml get /workspace/numbers
openapi: 3.0.0
info:
  title: Ringg AI API Documentation
  description: >-
    This is the documentation for the Ringg AI APIs. The Ringg AI API follows
    RESTful principles, making it intuitive and easy to integrate with your
    applications. All API requests should be made to the base URL. The API
    accepts and returns data in JSON format. Ensure your requests include the
    appropriate Content-Type header for POST and PATCH requests.
  version: 2.0.0
servers:
  - url: https://prod-api.ringg.ai/ca/api/v0
security: []
tags:
  - name: workspace
    description: Endpoints for managing your workspace.
  - name: agent
    description: Endpoints for managing assistants (agents).
  - name: calling
    description: Endpoints for making and managing calls.
  - name: campaign
    description: Endpoints for managing campaigns.
  - name: analytics
    description: Endpoints for accessing call analytics and performance metrics.
  - name: termination
    description: Endpoints for terminating active calls using different methods.
  - name: knowledgebase
    description: Endpoints for managing knowledge bases.
paths:
  /workspace/numbers:
    get:
      tags:
        - workspace
      summary: Get Workspace Numbers
      description: Retrieves a list of available phone numbers in your workspace.
      operationId: getWorkspaceNumbers
      parameters:
        - name: X-API-KEY
          in: header
          description: (Required) Your Ringg AI API key.
          required: true
          schema:
            type: string
            example: 7251cb4b-3373-43a4-844c-b27a1d45e0c9
        - name: limit
          in: query
          description: 'Number of items to return (default: 20, max: 100).'
          schema:
            type: integer
            default: 10
            example: 50
        - name: offset
          in: query
          description: 'Number of items to skip (default: 0).'
          schema:
            type: integer
            default: 0
            example: 20
      responses:
        '200':
          description: 'Successful Response: A list of available phone numbers.'
          content:
            application/json:
              schema:
                type: object
                properties:
                  workspace_numbers:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          example: 5d7f9a2b-1c3e-4f6a-8b9c-0d1e2f3a4b5c
                        number:
                          type: string
                          example: '+1234567890'
                        created_at:
                          type: string
                          format: date-time
                          example: '2024-12-16T13:03:29.947147+00:00'
                        call_count:
                          type: integer
                          example: 0
                        agent:
                          type: object
                          nullable: true
                          properties:
                            id:
                              type: string
                              example: 830f767a-397e-4b39-82ff-235cd344e2f9
                            agent_display_name:
                              type: string
                              example: Sales Assistant
                        is_inbound_enabled:
                          type: boolean
                          example: true
                        is_test_number:
                          type: boolean
                          example: false
                        tags:
                          type: array
                          items:
                            type: string
                          example: []
                        is_spam:
                          type: boolean
                          example: false
                        spam_message:
                          type: string
                          nullable: true
                          example: null
                        provider:
                          type: string
                          nullable: true
                          example: twilio
                        display_name:
                          type: string
                          nullable: true
                          example: Sales Line
                        owner:
                          type: string
                          nullable: true
                          example: demo@ringg.ai
                        is_custom_number:
                          type: boolean
                          example: false
                        telephony_id:
                          type: string
                          nullable: true
                          example: 0b84b167-2dcb-4bbd-abab-1837000bea17
                        number_pool_id:
                          type: string
                          nullable: true
                          example: 0b84b167-2dcb-4bbd-abab-1837000bea17
        '401':
          description: Unauthorized - Invalid or missing API key.
        '500':
          description: Internal Server Error - Something went wrong on our end.

````