Deeply API Documentation main logoDeeply API Documentation main logo textDeeply API Documentation main logo text
User GuideServer API Reference
k

Quick Start

API Quick Start Guide
Authorization
Rate Limit

Architecture

Overall Architecture
Edge Server System

Events

Events
Event Categories
List Events
GET
Get An Event
GET

Live Events

Live Events
Listen Live Events
WebSocket

Edges

Edge Server
List Edge Servers
GET
Get An Edge Server
GET
Update Edge Server
PATCH

Microphones

Mic Device
List Mic Devices
GET
Get A Mic Device
GET
Update Mic Device
PATCH

Auth

Reissue Token
GET

© 2025 Deeply Inc.

Deeply Logo Icon

Deeply API Documentation

    1. reference
    2. Devices
    3. List Devices

    List Mic Devices

    Get all registered mic devices

    GET
    /api/v1/mics

    Description

    API to retrieve a list of registered microphone devices. The result is paginated based on the provided query parameters. Refer to the Mic Device Object for more details.

    Each microphone has its own threshold values. Refer to Event Categories for more details.

    Authentication

    Access Token is required via Bearer token authentication. Refer to the Authentication section for more details.

    Response

    {
      "page": 1,
      "size": 10,
      "total_cnt": 100,
      "max_page": 10,
      "results": [
        {
          "id": "string",
          "name": "string",
          "host": "string",
          "edge_id": "string",
          "status": "enum(active | inactive)",
          "thresholds": {
            "[event_category]": 0.5
          },
          "location": {
            "latitude": -90,
            "longitude": -180
          },
          "created_at": "2019-08-24T14:15:22Z",
          "updated_at": "2019-08-24T14:15:22Z"
        }
      ]
    }

    Request Examples

    Run In Postman

    Basic Request

    const response = await fetch('https://openapi.deeplyinc.com/api/v1/mics?page=1&size=10', {
      method: 'GET',
      headers: {
        "Authorization": "Bearer YOUR_ACCESS_TOKEN"
      }
    });
    
    const data = await response.json();

    Request with Filters

    const response = await fetch('https://openapi.deeplyinc.com/api/v1/mics?name=mic1&edge_id=edge123&page=1&size=10', {
      method: 'GET',
      headers: {
        "Authorization": "Bearer YOUR_ACCESS_TOKEN"
      }
    });
    
    const data = await response.json();
    Mic Device
    Get A Mic Device

    On this page

    DescriptionAuthenticationResponseRequest ExamplesBasic RequestRequest with Filters

    Query Parameters

    page
    optional
    integer || 1
    size
    optional
    integer || 10
    name
    optional
    string || null
    edge_id
    optional
    string || null

    Page number for pagination (must be > 0)

    Number of items per page (must be > 0 and < 101)

    Filter devices by name

    Filter devices by edge server ID