API Reference
The Phosra API provides 82 endpoints organized into the following groups. All endpoints use the base URL https://phosra-api.fly.dev/api/v1.
Endpoint Groups
Authentication
Register, login, refresh tokens, and manage sessions. 5 endpoints
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 45 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
Register webhook endpoints for real-time event notifications. 6 endpoints
Standards
Browse and adopt community safety standards. 5 endpoints
Ratings
Content rating systems (MPAA, ESRB, PEGI) and age lookups. 2 endpoints
Devices
Register Apple devices and manage on-device enforcement. 4 endpoints
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:
{
"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.