Access Token Device Information

Every access token carries a .device object that says what kind of device, browser and application the token is used from, and whether the caller is a bot or an AI assistant.

Migration from .agent The .agent property has been deprecated and replaced with .device.

These are the fields of .device

Property	Type	Description
`device_type`	`string\|null`	Type of device: `"mobile"`, `"desktop"`, `"tablet"`, `"server"`, or `null`
`device_os`	`string\|null`	Operating system: `"mac"`, `"windows"`, `"linux"`, `"android"`, `"ios"`, `"chromeos"`, `"other"`, or `null`
`application`	`string\|null`	Application name (e.g., `"chrome-mac"`, `"safari-ios"`) or `null`
`browser`	`string\|null`	Browser engine: `"chrome"`, `"firefox"`, `"safari"`, `"edge"`, `"electron"`, or `null`
`browser_version`	`string\|null`	Version of the browser engine (e.g., `"120.0.0.0"`) or `null`
`device_version`	`string\|null`	Operating system version (e.g., `"10.15.7"`, `"18.3.2"`) or `null`
`is_mobile`	`boolean`	`true` if the device is a mobile phone
`is_tablet`	`boolean`	`true` if the device is a tablet
`is_desktop`	`boolean`	`true` if the device is a desktop or laptop
`is_bot`	`boolean`	`true` if the request comes from a bot or crawler
`is_ai`	`boolean`	`true` if the bot is an AI assistant or training bot
`ai_type`	`string\|null`	Type of AI bot: `"crawl"` (training/research) or `"user"` (user-initiated), or `null`

What a desktop browser looks like

Chrome on macOS

Chrome Desktop Device Info

{
  "ai_type": null,
  "application": "chrome-mac",
  "browser": "chrome",
  "browser_version": "140.0.0.0",
  "device_os": "mac",
  "device_type": "desktop",
  "device_version": "10.15.7",
  "is_ai": false,
  "is_bot": false,
  "is_desktop": true,
  "is_mobile": false,
  "is_tablet": false
}

Safari on macOS

Safari Desktop Device Info

{
  "ai_type": null,
  "application": "safari-mac",
  "browser": "safari",
  "browser_version": "17.0",
  "device_os": "mac",
  "device_type": "desktop",
  "device_version": "10.15.7",
  "is_ai": false,
  "is_bot": false,
  "is_desktop": true,
  "is_mobile": false,
  "is_tablet": false
}

What a mobile device looks like

iPhone Safari

iPhone Device Info

{
  "ai_type": null,
  "application": "safari-ios",
  "browser": "safari",
  "device_os": "ios",
  "device_type": "mobile",
  "device_version": "18.3.2",
  "is_ai": false,
  "is_bot": false,
  "is_desktop": false,
  "is_mobile": true,
  "is_tablet": false
}

Android Chrome

Android Device Info

{
  "ai_type": null,
  "application": "chrome-android",
  "browser": "chrome",
  "browser_version": "114.0.0.0",
  "device_os": "android",
  "device_type": "mobile",
  "device_version": "10",
  "is_ai": false,
  "is_bot": false,
  "is_desktop": false,
  "is_mobile": true,
  "is_tablet": false
}

What a tablet looks like

iPad

iPad Device Info

{
  "ai_type": null,
  "application": "safari-ios",
  "browser": "safari",
  "browser_version": "17.0",
  "device_os": "ios",
  "device_type": "tablet",
  "device_version": "17.0",
  "is_ai": false,
  "is_bot": false,
  "is_desktop": false,
  "is_mobile": false,
  "is_tablet": true
}

What bots and AI assistants look like

Search engine bot

Google Bot Device Info

{
  "ai_type": null,
  "application": "googlebot",
  "browser": "googlebot",
  "device_os": null,
  "device_type": "server",
  "is_ai": false,
  "is_bot": true,
  "is_desktop": false,
  "is_mobile": false,
  "is_tablet": false
}

AI assistant, user-initiated

ChatGPT User Device Info

{
  "ai_type": "user",
  "application": "chatgpt-user",
  "browser": "chatgpt-user",
  "browser_version": "1.0",
  "device_os": null,
  "device_type": "server",
  "is_ai": true,
  "is_bot": true,
  "is_desktop": false,
  "is_mobile": false,
  "is_tablet": false
}