API Reference

This section documents Phosra's own Parental Controls product — the families, children, policies, and enforcement API that Phosra has built on the platform. It is one product built on top of the OCSS-conformant control plane, not the control plane itself. If you are building a third-party tool, agent, or enforcement partner integration, start with the Developer Platform instead.

The Phosra API provides 82 endpoints organized into the following groups. All endpoints use the base URL https://prodapi.phosra.com/api/v1.

Endpoint Groups

Authentication

Families

Create and manage family groups and their members. 8 endpoints

Children

Add children to families, manage profiles, and get age ratings. 6 endpoints

Policies

Create, activate, pause, and auto-generate safety policies. 8 endpoints

Rules

Manage individual rules across 110 safety categories. 5 endpoints

Enforcement

Push policies to platforms and track enforcement jobs. 6 endpoints

Platforms

Browse and filter supported integration platforms. 4 endpoints

Compliance

Connect, verify, and manage platform connections. 5 endpoints

Webhooks

Standards

Browse and adopt community safety standards. 5 endpoints

Ratings

Content rating systems (MPAA, ESRB, PEGI) and age lookups. 2 endpoints

Devices

Authentication

Most endpoints require authentication via Bearer token or API key. See the Authentication guide for details. Public endpoints (platforms, ratings, standards) are marked with security: [] in the OpenAPI spec.

Response Format

All responses return JSON. Successful responses return the resource directly. Error responses follow the format:

json

{
  "error": "error_code",
  "message": "Human-readable description"
}

See the Errors page for details on status codes and error handling.

OpenAPI Spec

The full OpenAPI 3.1 specification is available at /openapi.yaml. Use it with code generators, Postman, Insomnia, or any OpenAPI-compatible tool.