Skip to main content
GET
/
families
/
{familyID}
/
children
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.children.list("f0000000-0000-4000-8000-0000000000f1");
console.log(result);
[
  {
    "id": "ca02f5d1-fee8-4201-b5ca-fdc8be506e1e",
    "family_id": "fcdf4277-ba14-4732-8db5-0369b2c88d8b",
    "name": "Ada",
    "birth_date": "2015-04-10T00:00:00Z",
    "created_at": "2026-06-18T14:32:07Z",
    "updated_at": "2026-06-30T09:15:44Z"
  }
]
A child belongs to a family and is the subject every policy, enforcement job, and rating lookup is scoped to. Add a child with a birth_date and Phosra derives age-appropriate rating tiers automatically. 
curl https://phosra-api-sandbox-production.up.railway.app/api/v1/families/$FAMILY_ID/children \
  -H "Authorization: Bearer $PHOSRA_API_KEY"

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
familyID
string<uuid>
required

Response

Children list

​
id
string<uuid>

Unique identifier for this resource.

​
family_id
string<uuid>

Identifier of the family this resource belongs to.

​
name
string

Human-readable display name.

​
birth_date
string<date-time>

Child's date of birth (YYYY-MM-DD). Used to derive the age-appropriate policy.

​
avatar_url
string

URL of the profile image.

​
created_at
string<date-time>

RFC 3339 timestamp of when the resource was created.