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

# Get Clean Numbers

> Returns a list of active clean phone numbers that can be used as caller IDs for voicemail drops. Numbers are filtered by group (overseas or inhouse) and scoped to your organization.



## OpenAPI

````yaml GET /clean-numbers
openapi: 3.0.1
info:
  title: CollectWise API
  description: >-
    An API for managing debtors, tracking statuses, and automating debt
    collection processes
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://collectwiseapi.com
security:
  - apiKey: []
paths:
  /clean-numbers:
    get:
      summary: Get clean numbers
      description: >-
        Returns a list of active clean phone numbers that can be used as caller
        IDs for voicemail drops. Numbers are filtered by group (overseas or
        inhouse) and scoped to your organization.
      parameters:
        - name: group
          in: query
          description: The group of clean numbers to retrieve
          required: true
          schema:
            type: string
            enum:
              - overseas
              - inhouse
      responses:
        '200':
          description: Clean numbers retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CleanNumbersResponse'
              example:
                numbers:
                  - phone_number: '+18667734413'
                count: 1
                group: overseas
        '400':
          description: Invalid or missing group parameter
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error: Invalid or missing group parameter
                message: 'group must be one of: overseas, inhouse'
components:
  schemas:
    CleanNumbersResponse:
      type: object
      properties:
        numbers:
          type: array
          description: List of active clean phone numbers
          items:
            type: object
            properties:
              phone_number:
                type: string
                description: Phone number in E.164 format
        count:
          type: integer
          description: Total number of clean numbers returned
        group:
          type: string
          description: The group that was queried
          enum:
            - overseas
            - inhouse
      required:
        - numbers
        - count
        - group
    Error:
      type: object
      required:
        - code
        - message
      properties:
        code:
          type: integer
          format: int32
          description: Error code
        message:
          type: string
          description: Error message
      example:
        code: 400
        message: 'Invalid input: debtorName is required'
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: collectwise_key

````