Device Information | Frame.io API Documentation

import requests
url = "https://api.frame.io/v2/devices/me"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.json())

{
  "_type": "project_device",
  "id": "4f2da3a9-71a3-4ab2-bcfe-b15a1b2c88e7",
  "asset_type": "video",
  "creator_id": "8437941d-dad1-467d-ba57-6758be7c5598",
  "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
    }
  },
  "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.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

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