Skip to main content
GET
/
platforms
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.platforms.list();
console.log(result);
[
  {
    "id": "fire_tablet",
    "name": "Amazon Fire Tablet",
    "category": "device",
    "tier": "pending",
    "description": "Amazon Fire Tablet Kids parental controls",
    "icon_url": "",
    "auth_type": "manual",
    "enabled": true,
    "capabilities": [
      "content_rating",
      "time_limit",
      "scheduled_hours",
      "web_filtering",
      "safe_search",
      "app_control",
      "purchase_control"
    ],
    "enforcement_mode": "manual_attested",
    "rule_support": {
      "addictive_design_control": "unsupported",
      "addictive_pattern_block": "unsupported",
      "adult_site_av_required": "unsupported",
      "age_appropriate_profile_mode": "unsupported",
      "age_gate": "unsupported",
      "age_signal_broadcast": "unsupported",
      "ai_chatbot_age_assertion": "unsupported",
      "ai_chatbot_tier_gate": "unsupported",
      "ai_companion_block": "unsupported",
      "ai_data_responsibility_rating_threshold": "unsupported",
      "ai_minor_interaction": "unsupported",
      "ai_no_csam_generation": "unsupported",
      "ai_no_engagement_dark_patterns": "unsupported",
      "ai_no_personhood_deception": "unsupported",
      "ai_no_self_harm_promotion": "unsupported",
      "ai_no_simulated_companionship": "unsupported",
      "ai_no_unsupervised_therapy": "unsupported",
      "ai_product_classification_gate": "unsupported",
      "ai_safety_rating_threshold": "unsupported",
      "ai_synthetic_media_disclosure": "unsupported",
      "ai_toy_safety_cert": "unsupported",
      "ai_training_data_opt_out": "unsupported",
      "ai_transparency_rating_threshold": "unsupported",
      "algo_feed_control": "unsupported",
      "algorithmic_audit": "unsupported",
      "app_install_block": "unsupported",
      "app_store_age_attestation": "unsupported",
      "autoplay_disable": "unsupported",
      "cipa_filter_attestation": "unsupported",
      "commercial_data_ban": "unsupported",
      "commercial_pressure_threshold": "unsupported",
      "content_allow_title": "guided",
      "content_allowlist_mode": "guided",
      "content_block_title": "guided",
      "content_descriptor_block": "guided",
      "content_rating": "guided",
      "crisis_resource_surface": "unsupported",
      "csam_reporting": "unsupported",
      "data_deletion_request": "unsupported",
      "data_minimization_enforce": "unsupported",
      "digital_literacy_curriculum_link": "unsupported",
      "dm_feature_disable": "unsupported",
      "dm_restriction": "unsupported",
      "dpia_request_generator": "unsupported",
      "dumbphone_migration_mode": "unsupported",
      "educational_credit": "unsupported",
      "ephemeral_message_disable": "unsupported",
      "esafety_commission_reporting": "unsupported",
      "firearm_content_block": "unsupported",
      "flagged_content_digest": "unsupported",
      "gambling_mechanics_block": "unsupported",
      "geolocation_opt_in": "unsupported",
      "geolocation_precision_cap": "unsupported",
      "hard_id_verification_escalation": "unsupported",
      "harm_report_intake": "unsupported",
      "image_content_monitoring": "unsupported",
      "image_rights_minor": "unsupported",
      "infinite_scroll_block": "unsupported",
      "library_filter_compliance": "unsupported",
      "message_content_monitoring": "unsupported",
      "minor_data_sale_audit_log": "unsupported",
      "monitoring_activity": "unsupported",
      "monitoring_alerts": "unsupported",
      "named_contact_block": "unsupported",
      "ncii_takedown": "unsupported",
      "not_for_minors_block": "unsupported",
      "notification_curfew": "unsupported",
      "os_age_signal_ingest": "unsupported",
      "parental_attestation_cert": "unsupported",
      "parental_consent_gate": "unsupported",
      "parental_event_notification": "unsupported",
      "phone_free_school_hours": "unsupported",
      "platform_liability_evidence_capture": "unsupported",
      "presence_status_hide": "unsupported",
      "privacy_account_creation": "unsupported",
      "privacy_data_sharing": "unsupported",
      "privacy_location": "unsupported",
      "privacy_profile_visibility": "unsupported",
      "privacy_rating_dimension_gate": "unsupported",
      "privacy_rating_score_threshold": "unsupported",
      "privacy_rating_tier_gate": "unsupported",
      "privacy_seal_required": "unsupported",
      "profanity_threshold": "unsupported",
      "prosocial_weight": "unsupported",
      "purchase_approval": "guided",
      "purchase_block_iap": "guided",
      "purchase_spending_cap": "guided",
      "rating_age_gate": "unsupported",
      "recognized_seal_allowlist": "unsupported",
      "representation_weight": "unsupported",
      "role_model_weight": "unsupported",
      "school_alert_routing": "unsupported",
      "screen_time_report": "unsupported",
      "search_query_monitoring": "unsupported",
      "sexual_content_threshold": "unsupported",
      "social_account_content_monitoring": "unsupported",
      "social_chat_control": "unsupported",
      "social_contacts": "unsupported",
      "social_media_min_age": "unsupported",
      "social_media_warning_label_render": "unsupported",
      "social_multiplayer": "unsupported",
      "stranger_dm_block": "unsupported",
      "stranger_outreach_friction": "unsupported",
      "streaming_age_rating_enforce": "unsupported",
      "student_privacy_school_mode": "unsupported",
      "substance_content_threshold": "unsupported",
      "targeted_ad_block": "unsupported",
      "teen_minimum_age_16_gate": "unsupported",
      "third_party_tracker_block": "unsupported",
      "time_daily_limit": "guided",
      "time_downtime": "guided",
      "time_per_app_limit": "guided",
      "time_scheduled_hours": "guided",
      "ugc_world_age_gate": "unsupported",
      "unrated_privacy_default": "unsupported",
      "usage_timer_notification": "unsupported",
      "violence_threshold": "unsupported",
      "voice_chat_minor_limit": "unsupported",
      "web_category_block": "guided",
      "web_custom_allowlist": "guided",
      "web_custom_blocklist": "guided",
      "web_filter_level": "guided",
      "web_safesearch": "guided"
    }
  },
  {
    "id": "fire_tv",
    "name": "Amazon Fire TV Stick",
    "category": "device",
    "tier": "pending",
    "description": "Amazon Fire TV parental controls",
    "icon_url": "",
    "auth_type": "manual",
    "enabled": true,
    "capabilities": [
      "content_rating",
      "app_control",
      "purchase_control"
    ],
    "enforcement_mode": "manual_attested",
    "rule_support": {
      "addictive_design_control": "unsupported",
      "addictive_pattern_block": "unsupported",
      "adult_site_av_required": "unsupported",
      "age_appropriate_profile_mode": "unsupported",
      "age_gate": "unsupported",
      "age_signal_broadcast": "unsupported",
      "ai_chatbot_age_assertion": "unsupported",
      "ai_chatbot_tier_gate": "unsupported",
      "ai_companion_block": "unsupported",
      "ai_data_responsibility_rating_threshold": "unsupported",
      "ai_minor_interaction": "unsupported",
      "ai_no_csam_generation": "unsupported",
      "ai_no_engagement_dark_patterns": "unsupported",
      "ai_no_personhood_deception": "unsupported",
      "ai_no_self_harm_promotion": "unsupported",
      "ai_no_simulated_companionship": "unsupported",
      "ai_no_unsupervised_therapy": "unsupported",
      "ai_product_classification_gate": "unsupported",
      "ai_safety_rating_threshold": "unsupported",
      "ai_synthetic_media_disclosure": "unsupported",
      "ai_toy_safety_cert": "unsupported",
      "ai_training_data_opt_out": "unsupported",
      "ai_transparency_rating_threshold": "unsupported",
      "algo_feed_control": "unsupported",
      "algorithmic_audit": "unsupported",
      "app_install_block": "unsupported",
      "app_store_age_attestation": "unsupported",
      "autoplay_disable": "unsupported",
      "cipa_filter_attestation": "unsupported",
      "commercial_data_ban": "unsupported",
      "commercial_pressure_threshold": "unsupported",
      "content_allow_title": "guided",
      "content_allowlist_mode": "guided",
      "content_block_title": "guided",
      "content_descriptor_block": "guided",
      "content_rating": "guided",
      "crisis_resource_surface": "unsupported",
      "csam_reporting": "unsupported",
      "data_deletion_request": "unsupported",
      "data_minimization_enforce": "unsupported",
      "digital_literacy_curriculum_link": "unsupported",
      "dm_feature_disable": "unsupported",
      "dm_restriction": "unsupported",
      "dpia_request_generator": "unsupported",
      "dumbphone_migration_mode": "unsupported",
      "educational_credit": "unsupported",
      "ephemeral_message_disable": "unsupported",
      "esafety_commission_reporting": "unsupported",
      "firearm_content_block": "unsupported",
      "flagged_content_digest": "unsupported",
      "gambling_mechanics_block": "unsupported",
      "geolocation_opt_in": "unsupported",
      "geolocation_precision_cap": "unsupported",
      "hard_id_verification_escalation": "unsupported",
      "harm_report_intake": "unsupported",
      "image_content_monitoring": "unsupported",
      "image_rights_minor": "unsupported",
      "infinite_scroll_block": "unsupported",
      "library_filter_compliance": "unsupported",
      "message_content_monitoring": "unsupported",
      "minor_data_sale_audit_log": "unsupported",
      "monitoring_activity": "unsupported",
      "monitoring_alerts": "unsupported",
      "named_contact_block": "unsupported",
      "ncii_takedown": "unsupported",
      "not_for_minors_block": "unsupported",
      "notification_curfew": "unsupported",
      "os_age_signal_ingest": "unsupported",
      "parental_attestation_cert": "unsupported",
      "parental_consent_gate": "unsupported",
      "parental_event_notification": "unsupported",
      "phone_free_school_hours": "unsupported",
      "platform_liability_evidence_capture": "unsupported",
      "presence_status_hide": "unsupported",
      "privacy_account_creation": "unsupported",
      "privacy_data_sharing": "unsupported",
      "privacy_location": "unsupported",
      "privacy_profile_visibility": "unsupported",
      "privacy_rating_dimension_gate": "unsupported",
      "privacy_rating_score_threshold": "unsupported",
      "privacy_rating_tier_gate": "unsupported",
      "privacy_seal_required": "unsupported",
      "profanity_threshold": "unsupported",
      "prosocial_weight": "unsupported",
      "purchase_approval": "guided",
      "purchase_block_iap": "guided",
      "purchase_spending_cap": "guided",
      "rating_age_gate": "unsupported",
      "recognized_seal_allowlist": "unsupported",
      "representation_weight": "unsupported",
      "role_model_weight": "unsupported",
      "school_alert_routing": "unsupported",
      "screen_time_report": "unsupported",
      "search_query_monitoring": "unsupported",
      "sexual_content_threshold": "unsupported",
      "social_account_content_monitoring": "unsupported",
      "social_chat_control": "unsupported",
      "social_contacts": "unsupported",
      "social_media_min_age": "unsupported",
      "social_media_warning_label_render": "unsupported",
      "social_multiplayer": "unsupported",
      "stranger_dm_block": "unsupported",
      "stranger_outreach_friction": "unsupported",
      "streaming_age_rating_enforce": "unsupported",
      "student_privacy_school_mode": "unsupported",
      "substance_content_threshold": "unsupported",
      "targeted_ad_block": "unsupported",
      "teen_minimum_age_16_gate": "unsupported",
      "third_party_tracker_block": "unsupported",
      "time_daily_limit": "unsupported",
      "time_downtime": "unsupported",
      "time_per_app_limit": "unsupported",
      "time_scheduled_hours": "unsupported",
      "ugc_world_age_gate": "unsupported",
      "unrated_privacy_default": "unsupported",
      "usage_timer_notification": "unsupported",
      "violence_threshold": "unsupported",
      "voice_chat_minor_limit": "unsupported",
      "web_category_block": "unsupported",
      "web_custom_allowlist": "unsupported",
      "web_custom_blocklist": "unsupported",
      "web_filter_level": "unsupported",
      "web_safesearch": "unsupported"
    }
  }
]
Platforms are the downstream services Phosra can push a child’s policy to — devices, DNS resolvers, gaming networks, and streaming apps. Each entry advertises its category, accreditation tier, auth_type, and a rule_support map describing which of the 123 OCSS categories it can enforce. This endpoint is public (security: []) — no token required — so you can browse the catalog before you authenticate. 
curl https://phosra-api-sandbox-production.up.railway.app/api/v1/platforms
Example response (live sandbox, truncated)
[
  {
    "id": "fire_tablet",
    "name": "Amazon Fire Tablet",
    "category": "device",
    "tier": "pending",
    "auth_type": "manual",
    "enforcement_mode": "manual_attested",
    "capabilities": ["content_rating", "time_limit", "scheduled_hours", "web_filtering", "safe_search", "app_control", "purchase_control"],
    "rule_support": { "age_gate": "unsupported", "addictive_pattern_block": "unsupported" }
  }
]
The live sandbox currently lists 22 platforms across four categories: device, dns, gaming, and streaming. Use Filter by category or Filter by capability to narrow the list.

Authorizations

​
Authorization
string
header
required

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

Response

Platform list

​
id
string

Unique identifier for this resource.

​
name
string

Human-readable display name.

​
category
enum<string>

OCSS rule category this rule enforces (see the Rule Categories reference).

Available options:
dns,
streaming,
gaming,
device,
browser
​
tier
enum<string>

Accreditation / integration tier of the platform.

Available options:
compliant,
provisional,
pending
​
description
string

Human-readable description.

​
icon_url
string

URL of the platform or resource icon.

​
auth_type
enum<string>

How the platform is authenticated (e.g. oauth, manual).

Available options:
api_key,
oauth2,
manual
​
enabled
boolean

Whether this item is currently active.

​
enforcement_mode
enum<string>

How Phosra enforces rules on this platform. dns = live DNS-provider API write (NextDNS/CleanBrowsing/Control D); device = on-device enforcement, requires Phosra app installed; api_write = live third-party write API; manual_attested = no programmatic API — Phosra generates setup steps and records a signed parent attestation. Never render "Enforced" for this value; coming_soon = adapter not yet built.

Available options:
dns,
device,
api_write,
manual_attested,
coming_soon
​
rule_support
object

Per-category enforcement support across all 123 OCSS rule categories. dns = DNS provider can filter this category; device = on-device enforcement handles it; guided = manual_attested platform, parent applies with Phosra guidance; unsupported = not addressable on this platform.