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

# List phone numbers for the current business.

> Lists phone numbers visible to the current business with paging, sorting, and filters for messaging, calling, and warmup management.



## OpenAPI

````yaml /openapi.json post /phone-numbers/all/business
openapi: 3.0.4
info:
  title: Leadping API
  description: >-
    Leadping API for lead intake, messaging, calling, automations, billing,
    business settings, and compliant lead communication workflows.
  license:
    name: MIT
    url: https://opensource.org/licenses/MIT
  version: v1
servers:
  - url: https://api.leadping.ai
    description: Production
security: []
tags:
  - name: Analytics
  - name: Automations
  - name: Contact
  - name: Conversations
  - name: Dispositions
  - name: Feedback
  - name: Leads
  - name: LeadStatuses
  - name: Notifications
  - name: OutboundDelivery
  - name: Sources
  - name: Suppressions
  - name: Tags
  - name: Users
  - name: Calls
  - name: PhoneNumbers
  - name: Sms
  - name: Telephony
  - name: UserDataExports
  - name: CallEvents
  - name: Events
  - name: SmsEvents
  - name: Businesses
  - name: PaymentMethods
  - name: Transactions
  - name: Usage
  - name: Wallets
paths:
  /phone-numbers/all/business:
    post:
      tags:
        - PhoneNumbers
      summary: List phone numbers for the current business.
      description: >-
        Lists phone numbers visible to the current business with paging,
        sorting, and filters for messaging, calling, and warmup management.
      operationId: PhoneNumbers_GetAllForCurrentBusiness
      requestBody:
        description: Pagination, filtering, and sorting options.
        content:
          application/json:
            schema:
              allOf:
                - $ref: '#/components/schemas/RequestDataOptions'
              description: >-
                Options for flexible, efficient, and explicit querying in Cosmos
                DB or similar repositories.
          application/*+json:
            schema:
              allOf:
                - $ref: '#/components/schemas/RequestDataOptions'
              description: >-
                Options for flexible, efficient, and explicit querying in Cosmos
                DB or similar repositories.
        required: true
      responses:
        '200':
          description: Phone numbers were successfully retrieved.
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/PagedResultOfPhoneNumberTableRow'
                description: >-
                  A generic container for paginated results returned to the
                  client.
        '400':
          description: The request was invalid or malformed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
components:
  schemas:
    RequestDataOptions:
      type: object
      properties:
        pageSize:
          pattern: ^-?(?:0|[1-9]\d*)$
          description: Maximum items to return in one page
          format: int32
        continuationToken:
          type: string
          description: >-
            Opaque Cosmos DB continuation token. ‑ on the **first** request. ‑
            Client must echo back the NextToken it received from the previous
            page.
          nullable: true
        orderBy:
          type: array
          items:
            allOf:
              - $ref: '#/components/schemas/OrderByOption'
            description: An object for ordering during querying
          description: List of sort instructions, in priority order.
          nullable: true
        includeCount:
          type: boolean
          description: Whether to include the total count in the response (for pagination).
          nullable: true
        search:
          type: string
          description: The search term to filter results (applied to ).
          nullable: true
        searchFields:
          type: array
          items:
            type: string
          description: >-
            The list of fields to apply the Search term to (must be string
            properties).
          nullable: true
        filters:
          type: array
          items:
            allOf:
              - $ref: '#/components/schemas/ExactMatchFilter'
            description: >-
              A generic object for handling exact match filtering during
              querying
          description: Key-value exact match filters (e.g., Status = Active).
          nullable: true
        rangeFilters:
          type: array
          items:
            allOf:
              - $ref: '#/components/schemas/RangeFilter'
            description: A generic object for handling range filtering during querying
          description: Advanced range-based filters (e.g., Price > 50 and Price <= 200).
          nullable: true
      description: >-
        Options for flexible, efficient, and explicit querying in Cosmos DB or
        similar repositories.
    PagedResultOfPhoneNumberTableRow:
      type: object
      properties:
        items:
          type: array
          items:
            allOf:
              - $ref: '#/components/schemas/PhoneNumberTableRow'
            description: >-
              List item schema for Leadping API phone number table row results
              shown in searchable tables.
          description: The subset of items returned for the current page.
        pageSize:
          pattern: ^-?(?:0|[1-9]\d*)$
          description: >-
            The number of items returned per page in the response. This may
            reflect the client's requested page size, or a server-defined
            default or limit.
          format: int32
        totalCount:
          pattern: ^-?(?:0|[1-9]\d*)$
          description: >-
            The total number of items that match the query across all pages. May
            be null if the count is not computed or not applicable (e.g., in
            continuation-based pagination).
          format: int32
          nullable: true
        continuationToken:
          type: string
          description: >-
            Opaque storage continuation token. ‑ `null` → the current page was
            the last page.
          nullable: true
      description: A generic container for paginated results returned to the client.
    ProblemDetails:
      type: object
      properties:
        type:
          type: string
          description: URI reference that identifies the problem type.
          nullable: true
        title:
          type: string
          description: Short, human-readable summary of the problem.
          nullable: true
        status:
          pattern: ^-?(?:0|[1-9]\d*)$
          description: HTTP status code returned for the problem.
          format: int32
          nullable: true
        detail:
          type: string
          description: >-
            Human-readable explanation specific to this occurrence of the
            problem.
          nullable: true
        instance:
          type: string
          description: >-
            URI reference that identifies this specific occurrence of the
            problem.
          nullable: true
    OrderByOption:
      type: object
      properties:
        field:
          type: string
          description: The field to sort by.
        direction:
          enum:
            - asc
            - desc
          type: string
          description: An enumerator for sort direction during querying
          nullable: true
      description: An object for ordering during querying
    ExactMatchFilter:
      type: object
      properties:
        value:
          description: The value that the field must match.
        field:
          type: string
          description: The field to filter by.
      description: A generic object for handling exact match filtering during querying
    RangeFilter:
      type: object
      properties:
        greaterThan:
          description: The exclusive lower bound for the field value.
        greaterThanOrEqual:
          description: The inclusive lower bound for the field value.
        lessThan:
          description: The exclusive upper bound for the field value.
        lessThanOrEqual:
          description: The inclusive upper bound for the field value.
        field:
          type: string
          description: The field to filter by.
      description: A generic object for handling range filtering during querying
    PhoneNumberTableRow:
      type: object
      properties:
        id:
          type: string
          description: Unique Leadping identifier for this phone number table row.
        name:
          type: string
          description: >-
            Optional display label for this phone number table row in the
            Leadping API.
        number:
          type: string
          description: E.164 phone number exposed by this phone number table row.
        type:
          type: string
          description: >-
            Type classification used to route and interpret this phone number
            table row in the Leadping API.
        business:
          type: string
          description: Business summary connected to this phone number table row.
        businessId:
          type: string
          description: >-
            Unique Leadping business identifier connected to this phone number
            table row.
          nullable: true
        enabled:
          type: boolean
          description: >-
            Indicates whether this phone number table row is active and
            available in the Leadping API.
        warmup:
          allOf:
            - $ref: '#/components/schemas/PhoneNumberReadiness'
          description: Warmup state for this phone number.
        ownership:
          type: string
          description: >-
            Ownership classification for this phone number, such as
            Leadping-owned or customer-owned.
        routingSummary:
          type: string
          description: Human-readable routing summary for this phone number.
        smsReady:
          type: boolean
          description: >-
            Indicates whether SMS messaging is ready for this business or phone
            number.
        voiceReady:
          type: boolean
          description: >-
            Indicates whether voice calling is ready for this business or phone
            number.
        tenDlcCampaignStatus:
          type: string
          description: 10DLC campaign status associated with this sender or SMS event.
          nullable: true
      description: >-
        List item schema for Leadping API phone number table row results shown
        in searchable tables.
    PhoneNumberReadiness:
      type: object
      properties:
        enabled:
          type: boolean
          description: Indicates whether phone number warmup is enabled in Leadping.
        state:
          enum:
            - Not Started
            - In Progress
            - Paused
            - Blocked
            - Ready
          type: string
          description: Defines the supported SMS readiness states.
          nullable: true
        healthStatus:
          enum:
            - Not Evaluated
            - Evaluating
            - Healthy
            - Needs Attention
            - Blocked
          type: string
          description: Defines the supported SMS readiness health assessments.
          nullable: true
        healthScore:
          pattern: ^-?(?:0|[1-9]\d*)$
          description: Current warmup health score used to assess phone number warmup.
          format: int32
        progressPercent:
          pattern: ^-?(?:0|[1-9]\d*)$
          description: Warmup completion percentage, from 0 through 100.
          format: int32
        callStage:
          enum:
            - Stage 0
            - Stage 1
            - Stage 2
            - Stage 3
            - Stage 4
          type: string
          description: >-
            Defines the supported voice call warmup stages for a
            Leadping-managed phone number.
          nullable: true
      description: Messaging and calling warmup for a Leadping phone number.

````