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

# Browse available numbers

> Browse purchasable Vobiz DIDs for the managed path. Read-only, no spend; restricted 140/1600-series and Aadhaar-gated numbers are filtered out server-side. Returns 503 when the Vobiz DID API is not configured (the workspace then provisions managed numbers manually). Scope `phone_numbers:read`.



## OpenAPI

````yaml /api-reference/openapi.json get /phone-numbers/available
openapi: 3.1.0
info:
  title: Lehar API
  version: v0
  description: >-
    Customer-facing REST API for the Lehar voice-AI platform. Platform-admin
    endpoints are intentionally excluded from this reference. Regenerate with
    `npm run sync:openapi`.
servers:
  - url: https://api.lehar.ai/ca/api/v0
security:
  - ApiKeyAuth: []
  - BearerAuth: []
paths:
  /phone-numbers/available:
    get:
      tags:
        - Phone Numbers
      summary: Browse available numbers
      description: >-
        Browse purchasable Vobiz DIDs for the managed path. Read-only, no spend;
        restricted 140/1600-series and Aadhaar-gated numbers are filtered out
        server-side. Returns 503 when the Vobiz DID API is not configured (the
        workspace then provisions managed numbers manually). Scope
        `phone_numbers:read`.
      operationId: list_available_numbers_ca_api_v0_phone_numbers_available_get
      parameters:
        - name: limit
          in: query
          required: false
          description: Maximum DIDs to return.
          schema:
            type: integer
            default: 25
            maximum: 100
        - name: country
          in: query
          required: false
          description: Country filter passed through to the inventory provider.
          schema:
            type: string
        - name: search
          in: query
          required: false
          description: >-
            E.164 substring to match. The `pattern` query param is accepted as
            an alias.
          schema:
            type: string
      responses:
        '200':
          description: >-
            Available DIDs. Unwrapped `data` array only (no pagination block).
            `number_type` is always null (not present in the provider payload).
          content:
            application/json:
              example:
                data:
                  - number: '+918045678901'
                    country: IN
                    region: Karnataka
                    number_type: null
                    setup_price: '0.00'
                    monthly_price: '150.00'
                    currency: INR
        '400':
          description: The `limit` parameter is not an integer.
          content:
            application/json:
              example:
                error:
                  code: invalid_request
                  message: limit must be an integer
        '401':
          description: Authentication required.
          content:
            application/json:
              example:
                error:
                  code: unauthorized
                  message: Authentication required
        '403':
          description: Caller lacks the required scope.
          content:
            application/json:
              example:
                error:
                  code: forbidden
                  message: Scope 'phone_numbers:read' is required
        '503':
          description: >-
            Number browsing is not configured, or the inventory provider is
            unreachable.
          content:
            application/json:
              example:
                error:
                  code: service_unavailable
                  message: >-
                    Number browsing is not available — this workspace provisions
                    managed numbers manually. Enter the DID your account manager
                    quoted instead.
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-KEY
    BearerAuth:
      type: http
      scheme: bearer

````