Quickstart

curl -X POST "$PHOSRA_BASE_URL/setup/quick" \
  -H "Content-Type: application/json" \
  -d '{
    "child_name": "Emma",
    "birth_date": "2016-03-15",
    "strictness": "recommended"
  }'

const BASE = "https://phosra-api-sandbox-production.up.railway.app/api/v1";

const res = await fetch(`${BASE}/setup/quick`, {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    child_name: "Emma",
    birth_date: "2016-03-15",
    strictness: "recommended",
  }),
});
const setup = await res.json();

console.log(setup.child.id);          // child UUID — keep this for step 3
console.log(setup.policy.status);     // "active"
console.log(setup.rules.length);      // 20

import requests

BASE = "https://phosra-api-sandbox-production.up.railway.app/api/v1"

res = requests.post(f"{BASE}/setup/quick", json={
    "child_name": "Emma",
    "birth_date": "2016-03-15",
    "strictness": "recommended",
}, timeout=30)
res.raise_for_status()
setup = res.json()

print(setup["child"]["id"])          # child UUID — keep this for step 3
print(setup["policy"]["status"])     # "active"
print(len(setup["rules"]))           # 20

package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"net/http"
)

const base = "https://phosra-api-sandbox-production.up.railway.app/api/v1"

func main() {
	body, _ := json.Marshal(map[string]string{
		"child_name": "Emma",
		"birth_date": "2016-03-15",
		"strictness": "recommended",
	})
	res, _ := http.Post(base+"/setup/quick", "application/json", bytes.NewReader(body))

	var setup struct {
		Child struct {
			ID string `json:"id"`
		} `json:"child"`
		Policy struct {
			Status string `json:"status"`
		} `json:"policy"`
		Rules []json.RawMessage `json:"rules"`
	}
	json.NewDecoder(res.Body).Decode(&setup)
	res.Body.Close()
	fmt.Println(setup.Child.ID, setup.Policy.Status, len(setup.Rules)) // …, active, 20
}

curl "$PHOSRA_BASE_URL/platforms"

const platforms = await fetch(`${BASE}/platforms`).then((r) => r.json());
for (const p of platforms) {
  console.log(p.id, p.name, p.enforcement_mode);
}

platforms = requests.get(f"{BASE}/platforms", timeout=30).json()
for p in platforms:
    print(p["id"], p["name"], p["enforcement_mode"])

package main

import (
	"encoding/json"
	"fmt"
	"net/http"
)

const base = "https://phosra-api-sandbox-production.up.railway.app/api/v1"

func main() {
	res, _ := http.Get(base + "/platforms")
	var platforms []struct {
		ID              string `json:"id"`
		Name            string `json:"name"`
		EnforcementMode string `json:"enforcement_mode"`
	}
	json.NewDecoder(res.Body).Decode(&platforms)
	res.Body.Close()

	for _, p := range platforms {
		fmt.Println(p.ID, p.Name, p.EnforcementMode)
	}
	// 22 platforms: android (device), cleanbrowsing (dns), fire_tablet (manual_attested), …
}

CHILD_ID="b687bde1-9b54-44ee-97af-b97505164321"   # from step 1

# Kick off enforcement → 202 with a job id
JOB=$(curl -s -X POST "$PHOSRA_BASE_URL/children/$CHILD_ID/enforce" | jq -r .id)

# Poll the job until it completes
curl -s "$PHOSRA_BASE_URL/enforcement/jobs/$JOB" | jq '{status, completed_at}'

const childId = setup.child.id; // from step 1

const job = await fetch(`${BASE}/children/${childId}/enforce`, { method: "POST" })
  .then((r) => r.json());
console.log(job.status); // "running"

const done = await fetch(`${BASE}/enforcement/jobs/${job.id}`).then((r) => r.json());
console.log(done.status); // "completed"

child_id = setup["child"]["id"]  # from step 1

job = requests.post(f"{BASE}/children/{child_id}/enforce", timeout=30).json()
print(job["status"])  # "running"

done = requests.get(f"{BASE}/enforcement/jobs/{job['id']}", timeout=30).json()
print(done["status"])  # "completed"

package main

import (
	"encoding/json"
	"fmt"
	"net/http"
)

const base = "https://phosra-api-sandbox-production.up.railway.app/api/v1"

func main() {
	childID := "b687bde1-9b54-44ee-97af-b97505164321" // from step 1

	res, _ := http.Post(base+"/children/"+childID+"/enforce", "application/json", nil)
	var job struct{ ID, Status string }
	json.NewDecoder(res.Body).Decode(&job)
	res.Body.Close()
	fmt.Println(job.Status) // "running"

	res, _ = http.Get(base + "/enforcement/jobs/" + job.ID)
	var done struct{ Status string }
	json.NewDecoder(res.Body).Decode(&done)
	res.Body.Close()
	fmt.Println(done.Status) // "completed"
}

{
  "id": "a67e91f6-522f-45b7-82f0-a8ccc9e9cf2f",
  "child_id": "b687bde1-9b54-44ee-97af-b97505164321",
  "policy_id": "5e2f1042-42eb-4ea9-8373-139896a4cd4d",
  "trigger_type": "manual",
  "status": "running",
  "started_at": "2026-07-06T02:36:34.868705Z"
}

{
  "id": "a67e91f6-522f-45b7-82f0-a8ccc9e9cf2f",
  "child_id": "b687bde1-9b54-44ee-97af-b97505164321",
  "policy_id": "5e2f1042-42eb-4ea9-8373-139896a4cd4d",
  "status": "completed",
  "started_at": "2026-07-06T02:36:34.868705Z",
  "completed_at": "2026-07-06T02:36:34.888135Z"
}