Skip to main content
GET
/
children
/
{childID}
/
devices
SDK (@phosra/sdk)
import { PhosraClient } from "@phosra/sdk";

const phosra = new PhosraClient({
  baseUrl: "https://phosra-api-sandbox-production.up.railway.app/api/v1",
  accessToken: process.env.PHOSRA_API_KEY,
});

const result = await phosra.devices.list("a11ce0fa-0000-4000-8000-0000000000a1");
console.log(result);
[
  {
    "id": "5e0a9c37-1b64-4d82-96f3-2c8a7e0b4d19",
    "child_id": "ca02f5d1-fee8-4201-b5ca-fdc8be506e1e",
    "family_id": "fcdf4277-ba14-4732-8db5-0369b2c88d8b",
    "platform_id": "nextdns",
    "device_name": "Ada's iPhone",
    "device_model": "iPhone15,3",
    "os_version": "18.5",
    "app_version": "2.4.0",
    "apns_token": "8f7d3c1b2a90e64f5d8c7b6a1f0e9d3c2b1a0f9e8d7c6b5a4f3e2d1c0b9a8f7e6",
    "capabilities": [
      "FamilyControls",
      "ManagedSettings",
      "DeviceActivity"
    ],
    "enforcement_summary": {},
    "last_seen_at": "2026-07-05T22:04:18Z",
    "last_policy_version": 0,
    "status": "active",
    "created_at": "2026-06-18T14:32:07Z",
    "updated_at": "2026-06-30T09:15:44Z"
  }
]

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
childID
string<uuid>
required

Response

Device list

​
id
string<uuid>

Unique identifier for this resource.

​
child_id
string<uuid>

Identifier of the child this resource belongs to.

​
family_id
string<uuid>

Identifier of the family this resource belongs to.

​
platform_id
string

Identifier of the associated platform.

​
device_name
string

User-assigned device name (e.g. "Ada's iPhone").

​
device_model
string

Hardware model identifier (e.g. iPhone15,3).

​
os_version
string

Operating-system version reported by the device (e.g. 18.5).

​
app_version
string

Version of the Phosra app installed on the device.

​
apns_token
string | null

Apple Push Notification service device token; null until the device registers for push.

​
capabilities
string[]

Apple frameworks the device supports (e.g. FamilyControls, ManagedSettings, DeviceActivity)

​
enforcement_summary
object

Per-category enforcement results from the device's last enforcement_status report

​
last_seen_at
string<date-time> | null

RFC 3339 timestamp.

​
last_policy_version
integer

Policy version the device last successfully applied.

​
status
enum<string>

Current lifecycle state of the resource.

Available options:
active,
inactive,
revoked
​
created_at
string<date-time>

RFC 3339 timestamp of when the resource was created.

​
updated_at
string<date-time>

RFC 3339 timestamp of the resource's most recent update.