Device Information | Frame.io API Documentation

import requests
url = "https://api.frame.io/v2/devices/me"
response = requests.get(url)
print(response.json())

{
  "_type": "project_device",
  "id": "4f2da3a9-71a3-4ab2-bcfe-b15a1b2c88e7",
  "asset_type": "video",
  "creator_id": "8437941d-dad1-467d-ba57-6758be7c5598",
  "deleted_at": {},
  "device_id": "a6bde4d5-433d-40d9-89db-da46c484a499",
  "inserted_at": "2025-10-23T20:17:41.997130Z",
  "last_seen_at": "2025-10-23T20:28:33Z",
  "last_known_firmware_version": "1.0.0",
  "name": "Jpg-C2C-Hardware-123456789000000000",
  "project_id": "57b04261-a440-480b-b0e5-c2d3dee7591b",
  "updated_at": "2025-10-23T20:28:33.037163Z",
  "status": "offline",
  "timezone": "America/New_York",
  "authorization": {
    "_type": "project_device_authorization",
    "creator": {
      "_type": "user",
      "id": "8437941d-dad1-467d-ba57-6758be7c5598",
      "name": "Charlie Anderson"
    },
    "creator_id": "8437941d-dad1-467d-ba57-6758be7c5598",
    "id": "ec45e65f-ab5e-4c00-b56a-8edb14a2d6de",
    "inserted_at": "2025-10-23T20:28:33.033487Z",
    "project_device_id": "4f2da3a9-71a3-4ab2-bcfe-b15a1b2c88e7",
    "scopes": {
      "account_read": false,
      "action_create": false,
      "action_delete": false,
      "action_read": false,
      "action_update": false,
      "asset_create": true,
      "asset_delete": false,
      "asset_read": false,
      "asset_update": false,
      "auditlog_read": false,
      "comment_create": false,
      "comment_delete": false,
      "comment_read": false,
      "comment_update": false,
      "device_connect": false,
      "id": "string",
      "offline": true,
      "presentation_create": false,
      "presentation_delete": false,
      "presentation_read": false,
      "presentation_update": false,
      "project_create": false,
      "project_delete": false,
      "project_read": false,
      "project_update": false,
      "reviewlink_create": false,
      "reviewlink_delete": false,
      "reviewlink_read": false,
      "reviewlink_update": false,
      "team_create": false,
      "team_read": false,
      "team_update": false,
      "webhook_create": false,
      "webhook_delete": false,
      "webhook_read": false,
      "webhook_update": false
    },
    "expires_at": "2024-01-15T09:30:00Z"
  },
  "project": {
    "id": "57b04261-a440-480b-b0e5-c2d3dee7591b",
    "name": "C2C Demo v3",
    "_type": "project"
  },
  "channels": [
    {
      "_type": "project_device_channel",
      "id": "5fc73e79-1de7-4f8a-b016-6763e54d8c29",
      "actor_id": "8437941d-dad1-467d-ba57-6758be7c5598",
      "asset_type": "video",
      "device_id": "a6bde4d5-433d-40d9-89db-da46c484a499",
      "external_index": 0,
      "inserted_at": "2025-10-23T20:17:41.999683Z",
      "name": "Jpg C2C Hardware",
      "project_id": "57b04261-a440-480b-b0e5-c2d3dee7591b",
      "project_device_id": "4f2da3a9-71a3-4ab2-bcfe-b15a1b2c88e7",
      "real_time_logging_capable": false,
      "status": "offline",
      "updated_at": "2025-10-23T20:17:41.999683Z"
    }
  ]
}

Fetches information about the current device connection. Can be used to verify authorization token and returns information useful to present useful information in your user interface.

Headers

x-client-versionstringOptionalDefaults to 0.0.0

Firmware or software version of a C2C integration. Will be used to determine the correct Device Model configuration for the device when multiple are available. Must be a valid semantic version.

For more on semantic versions, see here: https://semver.org/

Firmware or software version of a C2C integration. Will be used to determine the correct Device Model configuration for the device when multiple are available. Must be a valid semantic version. For more on semantic versions, see here: https://semver.org/

Response

Device information response

_typestringDefaults to project_device

Resource type identifier

idstringformat: "uuid"

asset_typestring

The type of asset that this device will be producing

creator_idstringformat: "uuid"

deleted_atstringformat: "date-time"

device_idstringformat: "uuid"

inserted_atstringformat: "date-time"

last_seen_atstringformat: "date-time"

last_known_firmware_versionstring

The last known firmware version reported by the device

namestring<=255 characters

Name of this device as shown in the iOS app and web app

project_idstringformat: "uuid"

The Project ID that this device is linked to

updated_atstring

statusenum

Allowed values:

timezonestring

authorizationobject

Authorization details for a project device

projectobject

channelslist of objects

channel_countinteger<=100

path_asset_typestring<=50 characters

path_namestring<=50 characters

required_metadata_attributeslist of strings

Errors

401

Unauthorized Error