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

# List phone numbers

> Paginated list of phone numbers owned by the specified account.



## OpenAPI

````yaml https://api.itellico.ai/v1/openapi.json get /v1/accounts/{account_id}/phone-numbers
openapi: 3.1.0
info:
  title: itellicoAI API v1
  version: 1.0.0
  description: >-
    Public REST API for managing accounts, agents, telephony resources, and
    conversations.


    Authentication is via API key in the `X-API-Key` header.
  termsOfService: https://itellico.ai/legal/terms-and-conditions/
  contact:
    name: itellicoAI Support
    email: support@itellico.ai
  license:
    name: Proprietary
servers:
  - url: https://api.itellico.ai
    description: Production
security:
  - APIKeyAuth: []
tags:
  - name: Accounts
    description: >-
      Identify the current account context and fetch core account metadata to
      bootstrap API usage.
  - name: Subaccounts
    description: >-
      Create and manage child accounts under a parent to model tenant
      hierarchies and delegated access.
  - name: Agents
    description: >-
      Define and configure conversational agents (model, transcriber, voice,
      behavior) used in calls and automations.
  - name: Providers
    description: >-
      Discover available AI model, transcriber, and voice catalogs for the
      current account when configuring agents.
  - name: Phone Numbers
    description: >-
      Manage BYOC phone numbers bound to your account; route inbound calls to
      agents and enable outbound calling.
  - name: SIP Trunks
    description: >-
      Manage BYOC SIP trunk connectivity (origination/termination endpoints and
      allowed IPs) used by phone numbers.
  - name: Calls
    description: >-
      Create, list, inspect, and connect voice calls across phone and web
      channels.
  - name: Conversations
    description: List and inspect conversation activity across web and telephony channels.
  - name: Analytics
    description: Usage analytics and reporting endpoints for conversation activity.
paths:
  /v1/accounts/{account_id}/phone-numbers:
    get:
      tags:
        - Phone Numbers
      summary: List phone numbers
      description: Paginated list of phone numbers owned by the specified account.
      operationId: listPhoneNumbers
      parameters:
        - in: path
          name: account_id
          schema:
            format: uuid4
            title: Account Id
            type: string
          required: true
        - in: query
          name: limit
          schema:
            default: 100
            minimum: 1
            title: Limit
            type: integer
          required: false
        - in: query
          name: offset
          schema:
            default: 0
            minimum: 0
            title: Offset
            type: integer
          required: false
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/NinjaPaginationResponseSchema_PhoneNumberV1Out_
      security:
        - APIKeyAuth: []
components:
  schemas:
    NinjaPaginationResponseSchema_PhoneNumberV1Out_:
      properties:
        count:
          title: Count
          type: integer
        items:
          items:
            $ref: '#/components/schemas/PhoneNumberV1Out'
          title: Items
          type: array
      required:
        - count
        - items
      title: NinjaPaginationResponseSchema[PhoneNumberV1Out]
      type: object
    PhoneNumberV1Out:
      properties:
        id:
          format: uuid4
          title: Id
          type: string
        number:
          anyOf:
            - type: string
            - type: 'null'
          title: Number
        sip_trunk:
          anyOf:
            - $ref: '#/components/schemas/SIPTrunkBaseV1Out'
            - type: 'null'
        inbound_agent:
          anyOf:
            - $ref: '#/components/schemas/NumberAgentV1Out'
            - type: 'null'
        spam_data:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Spam Data
        friendly_name:
          anyOf:
            - maxLength: 100
              type: string
            - type: 'null'
          title: Friendly Name
        tellows_data:
          anyOf:
            - type: object
            - type: 'null'
          description: >-
            Tellows spam check data including score, complaints, caller info,
            and check timestamp
          title: Tellows Data
      required:
        - id
      title: PhoneNumberV1Out
      type: object
    SIPTrunkBaseV1Out:
      properties:
        id:
          format: uuid4
          title: Id
          type: string
        is_managed:
          title: Is Managed
          type: boolean
        name:
          description: Display name for this SIP trunk
          maxLength: 100
          title: Name
          type: string
      required:
        - id
        - is_managed
        - name
      title: SIPTrunkBaseV1Out
      type: object
    NumberAgentV1Out:
      properties:
        id:
          format: uuid4
          title: Id
          type: string
        name:
          maxLength: 200
          title: Name
          type: string
        avatar:
          anyOf:
            - type: string
            - type: 'null'
          title: Avatar
      required:
        - id
        - name
      title: NumberAgentV1Out
      type: object
  securitySchemes:
    APIKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key

````