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

# List inbound numbers

> Your Vacademy Voice numbers, which agent answers each and how calls are routed (the number's IVR menu).

Scope: `calls:read`.



## OpenAPI

````yaml /api-reference/openapi.json get /numbers
openapi: 3.1.0
info:
  title: Telleo API
  version: 1.3.0
  description: >-
    Start AI phone calls, or connect your counsellors to contacts, from your own
    systems and get each call's outcome back. Manage your counsellors and AI
    agents from the same API.
servers:
  - url: https://api.telleo.ai/v1
security:
  - ApiKey: []
tags:
  - name: Calls
  - name: Batches
  - name: Agents
  - name: Human calls
  - name: Counsellors
  - name: Credits
  - name: Webhook
paths:
  /numbers:
    get:
      tags:
        - Agents
      summary: List inbound numbers
      description: >-
        Your Vacademy Voice numbers, which agent answers each and how calls are
        routed (the number's IVR menu).


        Scope: `calls:read`.
      operationId: listNumbers
      responses:
        '200':
          description: Your inbound numbers.
          headers:
            X-Request-Id:
              $ref: '#/components/headers/RequestId'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NumberList'
              example:
                object: list
                has_more: false
                data:
                  - id: pn_1
                    object: number
                    phone_number: '+918045001234'
                    label: Admissions
                    provider: plivo
                    enabled: true
                    agent:
                      id: 17ea33d2-5b6c-4c1e-9a1f-2d4e6f8a9b0c
                      object: agent
                      name: Riya – admissions
                      enabled: true
                      direction: both
                    routing:
                      menu_id: m-1
                      menu_name: Admissions line
                      ai_agent_steps: 1
                      shared_with: []
                      type: ai_agent
                      description: An AI agent answers every call.
        '401':
          description: The key is missing, unknown, revoked or expired.
          headers:
            X-Request-Id:
              $ref: '#/components/headers/RequestId'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                missing_api_key:
                  value:
                    error:
                      code: missing_api_key
                      message: Send your API key in the X-API-Key header.
                      request_id: req_8f2c1a7e
                invalid_api_key:
                  value:
                    error:
                      code: invalid_api_key
                      message: This API key is not valid.
                      request_id: req_8f2c1a7e
        '429':
          description: Too many requests for this key.
          headers:
            Retry-After:
              schema:
                type: integer
              description: Seconds to wait before retrying.
            X-Request-Id:
              $ref: '#/components/headers/RequestId'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                rate_limited:
                  value:
                    error:
                      code: rate_limited
                      message: Too many requests. Retry after 12 seconds.
                      request_id: req_8f2c1a7e
components:
  headers:
    RequestId:
      schema:
        type: string
      description: Unique id of this request. Quote it to support.
  schemas:
    NumberList:
      type: object
      properties:
        object:
          type: string
          const: list
        data:
          type: array
          items:
            $ref: '#/components/schemas/Number'
        has_more:
          type: boolean
    Error:
      type: object
      required:
        - error
      properties:
        error:
          type: object
          required:
            - code
            - message
          properties:
            code:
              type: string
              description: Machine-readable code. Branch on this, not on the message.
              example: invalid_request
            message:
              type: string
              description: A sentence you can log or show to an operator.
            request_id:
              type: string
              description: Quote this when you contact support.
            details:
              type: object
              additionalProperties: true
              description: >-
                Extra context, e.g. `errors: [{field, message}]` for validation
                errors or `call_id` for conflicts.
    Number:
      type: object
      properties:
        id:
          type: string
        object:
          type: string
          const: number
        phone_number:
          type: string
          example: '+918045001234'
        label:
          type:
            - string
            - 'null'
        provider:
          type: string
          example: plivo
          description: Only Vacademy Voice (`plivo`) numbers answer with an AI agent.
        enabled:
          type: boolean
        agent:
          type:
            - object
            - 'null'
          properties:
            id:
              type: string
            object:
              type: string
            name:
              type: string
            enabled:
              type: boolean
            direction:
              type: string
            deleted:
              type: boolean
              description: The step points at an agent that no longer exists.
        routing:
          type: object
          properties:
            type:
              type: string
              enum:
                - ai_agent
                - menu_with_ai_agent
                - menu_with_several_ai_agents
                - menu_without_ai_agent
                - no_menu
            description:
              type: string
            menu_id:
              type: string
            menu_name:
              type: string
            ai_agent_steps:
              type: integer
            shared_with:
              type: array
              items:
                type: string
              description: Other numbers that play the same menu.
            agents:
              type: array
              items:
                type:
                  - object
                  - 'null'
                properties:
                  id:
                    type: string
                  object:
                    type: string
                  name:
                    type: string
                  enabled:
                    type: boolean
                  direction:
                    type: string
                  deleted:
                    type: boolean
                    description: The step points at an agent that no longer exists.
  securitySchemes:
    ApiKey:
      type: apiKey
      in: header
      name: X-API-Key
      description: >-
        Your AI calling API key (`vak_call_…`). `Authorization: Bearer <key>`
        also works.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.