# Live Response Samples These samples were captured from the demo tenant on the canonical People & Orgs Alpha implementation. Treat them as examples of shape, not as a copied data table. ## Descriptor ```json { "service": "platform3 People & Orgs Alpha API", "module": "people_and_orgs", "surface": "alpha", "belongsHereIf": "Who someone is and where they belong, as of a date.", "links": { "architecture": "https://platform3-andymontgomery-9773s-projects.vercel.app/people_and_orgs/alpha/architecture", "dataDictionary": "https://platform3-andymontgomery-9773s-projects.vercel.app/people_and_orgs/alpha/data_dictionary", "customerWebsite": "https://platform3-andymontgomery-9773s-projects.vercel.app/people_and_orgs/alpha/customer_website" } } ``` ## Student Roster Call: ```text GET /places/place_north_valley_school/people?asOfDate=2026-09-15&roleKind=student ``` Shape: ```json { "count": 4, "data": [ { "person_id": "person_ada_lovelace", "first_name": "Ada", "last_name": "Lovelace", "email": "ada@example.edu", "age_grade": 7, "primary_place_id": "place_north_valley_school", "membership": { "membership_id": "pm_ada_north_valley_student_2026", "role_kind": "student", "begin_date": "2026-06-01", "end_date": "2027-06-01", "is_time_locatable": true } }, { "person_id": "person_luis_rivera", "first_name": "Luis", "last_name": "Rivera", "email": "luis.rivera@example.edu", "age_grade": 7, "primary_place_id": "place_north_valley_school", "membership": { "membership_id": "pm_luis_rivera_north_valley_student_2026", "role_kind": "student", "begin_date": "2026-08-15", "end_date": "2027-06-01", "is_time_locatable": true } }, { "person_id": "person_maya_chen", "first_name": "Maya", "last_name": "Chen", "email": "maya.chen@example.edu", "age_grade": 7, "primary_place_id": "place_north_valley_school", "membership": { "membership_id": "pm_maya_chen_north_valley_student_2026", "role_kind": "student", "begin_date": "2026-08-15", "end_date": "2027-06-01", "is_time_locatable": true } }, { "person_id": "person_nora_patel", "first_name": "Nora", "last_name": "Patel", "email": "nora.patel@example.edu", "age_grade": 7, "primary_place_id": "place_north_valley_school", "membership": { "membership_id": "pm_nora_patel_north_valley_student_2026", "role_kind": "student", "begin_date": "2026-08-15", "end_date": "2027-06-01", "is_time_locatable": true } } ] } ``` ## District Boundary Call: ```text GET /places/place_timeback_physical_district/schools ``` Shape: ```json { "district": { "place_id": "place_timeback_physical_district", "name": "TimeBack Academy - Physical", "place_kind": "district", "nwea_district_id": "nwea-district-physical-001", "brand": "alpha", "modality": "physical" }, "schools": [ { "place_id": "place_north_valley_school", "place_kind": "school", "parent_place_id": "place_timeback_physical_district" } ] } ``` ## Students For Guide Call: ```text GET /guides/person_katherine_johnson/students?asOfDate=2026-09-15 ``` Shape: ```json { "guide_person_id": "person_katherine_johnson", "asOfDate": "2026-09-15", "data": [ { "guide_person_id": "person_katherine_johnson", "student_person_id": "person_ada_lovelace", "first_name": "Ada", "last_name": "Lovelace", "learning_group_id": "class_algebra_1_a", "school_id": "place_north_valley_school", "begin_date": "2026-06-01", "end_date": "2027-06-01" } ] } ``` ## School Calendar Range Call: ```text GET /places/place_north_valley_school/school_calendar?startDate=2025-08-13&endDate=2026-07-24 ``` Shape: ```json { "school_id": "place_north_valley_school", "startDate": "2025-08-13", "endDate": "2026-07-24", "count": 346, "school_days_in_range": 204, "data": [ { "calendar_date": "2025-08-13", "is_school_day": true, "reason": "instructional" }, { "calendar_date": "2025-11-24", "is_school_day": false, "reason": "holiday_break" } ] } ``` Use the returned `data[]` rows to compute the distinct `reason` values for a reported range. Do not keep a local reason table. ## Active School Period Memberships Call: ```text GET /school_periods/period_fall_2026/active_memberships?asOfDate=2026-09-15 ``` Shape: ```json { "school_period": { "period_id": "period_fall_2026", "period_kind": "term", "start_date": "2026-08-15", "end_date": "2026-12-18", "school_year": 2027 }, "place_memberships": [ { "membership_id": "pm_ada_north_valley_student_2026", "role_kind": "student" }, { "membership_id": "pm_grace_north_valley_guardian_2026", "role_kind": "guardian" }, { "membership_id": "pm_katherine_north_valley_guide_2026", "role_kind": "guide" }, { "membership_id": "pm_luis_rivera_north_valley_student_2026", "role_kind": "student" }, { "membership_id": "pm_maya_chen_north_valley_student_2026", "role_kind": "student" }, { "membership_id": "pm_nora_patel_north_valley_student_2026", "role_kind": "student" } ], "class_memberships": [ { "membership_id": "cm_advisory_katherine_guide_2026", "role_kind": "guide", "learning_group_id": "class_advisory_7b", "is_primary_guide": true }, { "membership_id": "cm_advisory_nora_student_2026", "role_kind": "student", "learning_group_id": "class_advisory_7b" }, { "membership_id": "cm_alg1_ada_student_2026", "role_kind": "student" }, { "membership_id": "cm_alg1_katherine_guide_2026", "role_kind": "guide", "learning_group_id": "class_algebra_1_a", "is_primary_guide": true }, { "membership_id": "cm_alg1_luis_student_2026", "role_kind": "student", "learning_group_id": "class_algebra_1_a" }, { "membership_id": "cm_alg1_maya_student_2026", "role_kind": "student", "learning_group_id": "class_algebra_1_a" } ] } ``` ## App Credential Redaction Call: ```text GET /app_credentials?filter=studentSourcedId==person_ada_lovelace ``` Shape: ```json { "count": 1, "data": [ { "student_sourced_id": "person_ada_lovelace", "app_id": "ixl_math", "has_credential": true, "last_rotated_at": "2026-11-01T09:00:00.000Z" } ] } ``` The response intentionally has no `secret_ref` field.