Products Solutions Developer Pricing Get For Free Download Sign in Sign up
Show topics

Application List (Batch)

Retrieves information about specific applications by their names.

Request

Property Value
Method POST
URL /api/applications/batch
Content-Type application/json
Authentication Bearer Token

Request Body

Parameter Type Required Description
data.names string[] Yes Array of application names

Example Request

{
  "data": {
    "names": ["edge", "origin"]
  }
}

Response

Status Codes

Code Description
200 Success
400 Bad Request - Invalid parameters
401 Unauthorized - Invalid or missing token
429 Too Many Requests - Rate limit exceeded
500 Internal Server Error

Successful Response (200)

{
  "data": {
    "found": [
      {
        "id": "edge",
        "name": "edge",
        "type": "EDGE",
        "class": "EdgeApplication",
        "streamCount": 2,
        "viewerCount": 0,
        "connectionCount": 0,
        "inBandwidth": 1078684,
        "outBandwidth": 0,
        "inTotalBytes": 160105566203,
        "outTotalBytes": 2118210760,
        "clusterType": true,
        "clusterConnection": true,
        "clusterConnectionData": {
          "cmIdentity": "mother superior",
          "connectionState": "AUTHENTICATED",
          "startDate": 1764671267591,
          "latency": 0,
          "packetReceived": 34581,
          "packetSend": 53010
        }
      }
    ],
    "notFound": [
      "origin"
    ]
  },
  "meta": {
    "executionTime": 0,
    "generatedAt": 1764844076976
  }
}

Response Body

Result Arrays

Parameter Type Description
data.found array Array of application objects that were found
data.notFound string[] Array of application names that were not found

Application Object

Parameter Type Description
data.found[].id string Unique identifier of the application
data.found[].name string Application name
data.found[].type MONO | ORIGIN | TRANSCODE | EDGE Application type
data.found[].class string Internal class name of the application
data.found[].streamCount integer Number of active streams
data.found[].viewerCount integer Number of connected viewers
data.found[].connectionCount integer Total number of connections
data.found[].inBandwidth integer Incoming bandwidth in bytes/sec
data.found[].outBandwidth integer Outgoing bandwidth in bytes/sec
data.found[].inTotalBytes integer Total incoming bytes
data.found[].outTotalBytes integer Total outgoing bytes
data.found[].clusterType boolean Indicates if this is a cluster application type
data.found[].clusterConnection boolean Indicates if cluster connection is active

Cluster Connection Data

Parameter Type Description
data.found[].clusterConnectionData object Cluster connection details (if applicable)
data.found[].clusterConnectionData.cmIdentity string Cluster manager identity
data.found[].clusterConnectionData.connectionState string Connection state
data.found[].clusterConnectionData.startDate integer Connection start time (Unix timestamp in ms)
data.found[].clusterConnectionData.latency integer Connection latency in milliseconds
data.found[].clusterConnectionData.packetReceived integer Total packets received
data.found[].clusterConnectionData.packetSend integer Total packets sent

Metadata

Parameter Type Description
meta.executionTime integer Request processing time in milliseconds
meta.generatedAt integer Response generation timestamp (Unix timestamp in ms)

Error Response (4xx/5xx)

{
  "message": "Error message"
}

Error Response Body

Parameter Type Description
message string Human-readable error message