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

# Search Devices

> Search devices by MAC address or name



## OpenAPI

````yaml https://api.voxo.co/v2/docs/openapi.json get /v2/admin/devices/search
openapi: 3.1.0
info:
  title: VOXO API
  description: VOXO Communication Platform API
  version: 2.0.0
servers:
  - url: https://api.voxo.co
security:
  - bearerAuth: []
paths:
  /v2/admin/devices/search:
    get:
      tags:
        - Devices
      summary: Search Devices
      description: Search devices by MAC address or name
      parameters:
        - schema:
            type: string
            maxLength: 17
            pattern: ^([0-9A-Fa-f]{2}[:-]){5}([0-9A-Fa-f]{2})$
          in: query
          name: mac
          required: false
          description: Filter by MAC address
        - schema:
            type: string
            maxLength: 255
          in: query
          name: name
          required: false
          description: Filter by device name
      responses:
        '200':
          description: Matching devices
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    id:
                      type: number
                      description: Device ID
                    name:
                      type: string
                      description: Device name
                    mac:
                      type: string
                      description: MAC address
                    tenantId:
                      type: number
                      description: Tenant ID
                    phLine1ExId:
                      anyOf:
                        - type: number
                        - type: 'null'
                      description: Primary line extension ID
                    extPeer:
                      anyOf:
                        - type: string
                        - type: 'null'
                      description: Extension SIP peer name
                    deviceModelId:
                      type: number
                      description: Device model ID
                    deviceModel:
                      type: string
                      description: Phone model name
                    tenantName:
                      type: string
                      description: Tenant name
                    tenantCode:
                      type: string
                      description: Tenant code
                    userAgent:
                      type: string
                      description: SIP user agent string
                  required:
                    - id
                    - name
                    - mac
                    - tenantId
                    - phLine1ExId
                    - extPeer
                    - deviceModelId
                    - deviceModel
                    - tenantName
                    - tenantCode
                    - userAgent
                  additionalProperties: false
        '400':
          description: Error response
          content:
            application/json:
              schema:
                type: object
                properties:
                  name:
                    type: string
                  message:
                    type: string
                  code:
                    type: number
                  validationErrors:
                    type: array
                    items:
                      type: string
                required:
                  - name
                  - message
                  - code
                additionalProperties: false
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````