Skip to main content
GET
/
families
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.families.list();
console.log(result);
[
  {
    "id": "fcdf4277-ba14-4732-8db5-0369b2c88d8b",
    "name": "Ada's Family",
    "created_at": "2026-06-18T14:32:07Z",
    "updated_at": "2026-06-30T09:15:44Z"
  }
]
A family is the top-level container that owns children, policies, and platform connections. Every parental-control workflow starts by creating (or listing) a family. 
curl https://phosra-api-sandbox-production.up.railway.app/api/v1/families \
  -H "Authorization: Bearer $PHOSRA_API_KEY"
Testing against the sandbox? Point calls at the sandbox base URL https://phosra-api-sandbox-production.up.railway.app/api/v1 with a phosra_test_ key. The @phosra/cli phosra init flow wires this for you.

Authorizations

​
Authorization
string
header
required

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

Response

Family list

​
id
string<uuid>

Unique identifier for this resource.

​
name
string

Human-readable display name.

​
created_at
string<date-time>

RFC 3339 timestamp of when the resource was created.