OpenTV ENTera & OpenTV Platform Documentation

Getting all the topics that a device is subscribed to

Request

To get a list of the topics that a device is subscribed to, send a GET request to:

Bash
http://<host>:<port>/mib/v1/devices/{deviceId}

Headers

  • Content-Type: application/json

Mandatory fields

  • deviceId – the ID of the device (as returned by ADM)

Example

This request gets details of the specified device, including the topics that it is subscribed to:

Bash
http://<host>:<port>/mib/v1/devices/5badca3e4e120d00011353b8

Response

A successful request returns an HTTP 200 status.

An unsuccessful request returns an HTTP 404 status if the device is not recognised.

A successful request generates a response that looks like this:

{
  "deviceId": "5fc9f023596f787fef9c43da",
  "deviceHardwareType": "Mobile",
  "deviceOS": "Android",
  "msgPlatform": "fcm",
  "userId": "5fc9f026996ecd7fe9cd07fe",
  "accountId": "5fc9f023596f787fef9c43dc",
  "active": true,
  "isConnected": true,
  "queueRegistrations": [
    {
      "enabled": true,
      "lastRegistrationDate": "2026-01-05T12:29:27.778Z",
      "queueApplicationName": "arn:aws:sns:us-east-1:439108492018:app/GCM/test-app",
      "queueApplicationARN": "arn:aws:sns:us-east-1:439108492018:app/GCM/test-app",
      "queueRegistrationId": "dhWEWbW7fW8:APA91bGg2UsbUW_umaq55Gq96II0slf5ICeGgpu3bmH3BjBkKw4QshEiW7Nj71BAz0z1t0bkQ5jaVXHTihGcFk_uqfewF9MrFlA3PrVjfQ0Xv-ro8e-cn-HlpodP1Z4AehFljuoq5LB-",
      "deviceQueueEndpointARN": "arn:aws:sns:us-east-1:439108492018:app/GCM/test-app/fa8fc99e-ac53-37b5-a64c-36b3c4bc730a"
    }
  ],
  "topics": [
    "GlobalTopicForAllDevices",
    "GlobalTopicForAndroidTV"
  ]
}

See also

For full details of this API, see the Device Messaging Manager (DMM) API documentation v1.