Get Phone Numbers

openapi: 3.1.0
info:
  title: Get Phone Numbers
  version: 1.0.0

paths:
  /api/phone-numbers:
    get:
      summary: Retrieve all phone numbers
      description: Returns all phone numbers configured for the authenticated workspace.
      tags:
        - Phone Numbers

      security:
        - bearerAuth: []

      responses:
        "200":
          description: Phone numbers retrieved successfully.

        "401":
          description: Unauthorized.

        "500":
          description: Internal Server Error.

components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

curl --location '{{baseUrl}}/api/phone-numbers' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN'

[
  {
    "_id": "6872d4b5f8d7a91234567890",
    "phoneNumber": "+14155552671",
    "provider": "Twilio",
    "country": "United States",
    "status": "Active",
    "assignedAgent": "Customer Support Agent",
    "createdAt": "2026-07-20T10:15:30.000Z"
  },
  {
    "_id": "6872d4b5f8d7a91234567891",
    "phoneNumber": "+919876543210",
    "provider": "Plivo",
    "country": "India",
    "status": "Active",
    "assignedAgent": "Sales Agent",
    "createdAt": "2026-07-20T11:05:42.000Z"
  }
]

{
  "success": false,
  "message": "Unauthorized"
}

{
  "success": false,
  "message": "Failed to retrieve phone numbers."
}