> For the complete documentation index, see [llms.txt](https://guide.fariaedu.com/integrations-portal/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guide.fariaedu.com/integrations-portal/managebac/public-rest-apis/v2p0/units.md).

# Units

A Unit is a unit plan that organizes curriculum delivery within a class, containing pedagogical content such as learning objectives, assessments, and resources.

## Get all Units

> This endpoint retrieves all unit plans. It returns unit details including title, description, pedagogical content, and associated class IDs.

```json
{"openapi":"3.0.3","info":{"title":"API V2P0","version":"v2p0"},"tags":[{"name":"Units","description":"A Unit is a unit plan that organizes curriculum delivery within a class, containing pedagogical content such as learning objectives, assessments, and resources."}],"servers":[{"url":"https://api.managebac.com","description":"CA ManageBac API server."},{"url":"https://api.managebac.cn","description":"CN ManageBac API server."},{"url":"https://api.us.managebac.com","description":"US1 ManageBac API server."},{"url":"https://api.managebac.us","description":"US2 ManageBac API server."},{"url":"https://api.managebactest.com","description":"UAT ManageBac API server."},{"url":"https://{Host}","variables":{"Host":{"default":"api.devel.managebac.com","enum":["api.devel.managebac.com","api-faria.devel.managebac.com","api.managebac.dev"]}}}],"security":[{"bearerAuth":[]},{"authTokenQuery":[]},{"authTokenHeader":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"OAuth 2.0 Bearer token obtained via client credentials grant. Pass the token in the Authorization header as `Bearer <token>`."},"authTokenQuery":{"type":"apiKey","name":"auth_token","in":"query","description":"Your V2 API authentication token may be passed in the parameters. To protect your key, use [environment variables](https://cloud.google.com/docs/authentication/api-keys#securing_an_api_key)."},"authTokenHeader":{"type":"apiKey","name":"auth-token","in":"header","description":"Your V2 API authentication token may be passed in the header. To protect your key, use [environment variables](https://cloud.google.com/docs/authentication/api-keys#securing_an_api_key)."}},"schemas":{"Unit":{"type":"object","properties":{"id":{"type":"integer","description":"Unique ID in ManageBac."},"title":{"type":"string","description":"Unit title."},"description":{"type":"string","description":"Unit description.","nullable":true},"archived":{"type":"boolean","description":"Whether the unit is archived."},"idu_unit":{"type":"boolean","description":"Whether this is an interdisciplinary unit.","nullable":true},"month":{"type":"integer","description":"Starting month number (1-12).","nullable":true},"week":{"type":"integer","description":"Starting week within the month.","nullable":true},"duration_in_weeks":{"type":"integer","description":"Duration in weeks.","nullable":true},"hours":{"type":"integer","description":"Number of hours.","nullable":true},"sl":{"type":"boolean","description":"Whether the unit is for Standard Level.","nullable":true},"hl":{"type":"boolean","description":"Whether the unit is for Higher Level.","nullable":true},"language_level":{"type":"string","description":"Language level.","nullable":true},"language_b_phases":{"type":"string","description":"Language B phases.","nullable":true},"subject":{"type":"object","description":"Subject information.","nullable":true,"properties":{"id":{"type":"integer","description":"Subject ID."},"name":{"type":"string","description":"Subject name."}}},"grade":{"type":"string","description":"Grade name."},"grade_number":{"type":"integer","description":"Grade number."},"class_ids":{"type":"array","description":"IDs of classes associated with this unit.","items":{"type":"integer"}},"start_date":{"type":"string","format":"date","description":"Computed start date of the unit.","nullable":true},"end_date":{"type":"string","format":"date","description":"Computed end date of the unit.","nullable":true},"central_idea":{"type":"string","description":"Central idea of the unit.","nullable":true},"guiding_questions":{"type":"object","description":"Guiding questions for the unit.","nullable":true,"properties":{"inquiry_questions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"line_of_inquiry":{"type":"string","nullable":true},"question":{"type":"string","nullable":true},"subjects":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"}}}},"labels":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"}}}}}}}}},"formative_assessment":{"type":"string","description":"Formative assessment details.","nullable":true},"summative_assessment":{"type":"string","description":"Summative assessment details.","nullable":true},"peer_self_assessment":{"type":"string","description":"Peer and self assessment details.","nullable":true},"standardization_and_moderation":{"type":"string","description":"Standardization and moderation details.","nullable":true},"methods":{"type":"string","description":"Methods used.","nullable":true},"prior_learning_experiences":{"type":"string","description":"Prior learning experiences.","nullable":true},"student_expectations":{"type":"string","description":"Student expectations.","nullable":true},"pedagogical_approaches":{"type":"object","description":"Pedagogical approaches.","nullable":true,"properties":{"selected":{"type":"array","items":{"type":"string"}},"text":{"type":"string","nullable":true}}},"teaching_strategies":{"type":"string","description":"Teaching strategies used.","nullable":true},"feedback":{"type":"string","description":"Feedback details.","nullable":true},"dispositions":{"type":"string","description":"Dispositions.","nullable":true},"international_mindedness":{"type":"string","description":"International mindedness.","nullable":true},"academic_honesty":{"type":"string","description":"Academic honesty.","nullable":true},"information_communication_technology":{"type":"string","description":"Information and communication technology.","nullable":true},"language_and_literacy_development":{"type":"object","description":"Language and literacy development.","nullable":true,"properties":{"options":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"text":{"type":"string","nullable":true}}},"cross_curricular_links":{"type":"object","description":"Cross-curricular links.","nullable":true,"properties":{"options":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"text":{"type":"string","nullable":true}}},"co_curricular_links":{"type":"object","description":"Co-curricular links.","nullable":true,"properties":{"options":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"text":{"type":"string","nullable":true}}},"differentiation":{"type":"object","description":"Differentiation details.","nullable":true,"properties":{"options":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"text":{"type":"string","nullable":true}}},"content":{"type":"string","description":"Content details.","nullable":true},"skills":{"type":"string","description":"Skills details.","nullable":true},"learning_process":{"type":"string","description":"Learning process details.","nullable":true},"metacognition":{"type":"object","description":"Metacognition details.","nullable":true,"properties":{"options":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"text":{"type":"string","nullable":true}}},"unit_activities":{"type":"array","description":"Unit activities.","nullable":true,"items":{"type":"object","properties":{"id":{"type":"integer"},"title":{"type":"string"}}}},"support_materials":{"type":"object","description":"Support materials.","nullable":true,"properties":{"options":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"text":{"type":"string","nullable":true}}},"concepts":{"type":"string","description":"Concepts.","nullable":true},"misunderstandings":{"type":"string","description":"Misunderstandings.","nullable":true},"transfer_goals":{"type":"string","description":"Transfer goals.","nullable":true},"lines_of_inquiry":{"type":"array","description":"Lines of inquiry for the unit (PYP only).","nullable":true,"items":{"type":"object","properties":{"id":{"type":"integer"},"line":{"type":"string"}}}},"student_questions":{"type":"array","description":"Student questions for the unit (PYP only).","nullable":true,"items":{"type":"object","properties":{"id":{"type":"integer"},"title":{"type":"string"}}}},"teacher_questions":{"type":"array","description":"Teacher questions for the unit (PYP only).","nullable":true,"items":{"type":"object","properties":{"id":{"type":"integer"},"title":{"type":"string"}}}},"learner_profiles":{"type":"array","description":"Learner profiles associated with the unit.","nullable":true,"items":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"}}}},"key_concepts":{"type":"object","description":"Key concepts and unit key concepts for the unit.","nullable":true,"properties":{"key_concepts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"concept":{"type":"string"}}}},"unit_key_concepts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"kind":{"type":"string","description":"Concept kind (e.g. form, function, causation).","nullable":true},"explanation_related_concept":{"type":"string","nullable":true}}}}}},"related_concepts":{"type":"object","description":"Related concepts for the unit (MYP only).","nullable":true,"properties":{"related_concepts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"subject_id":{"type":"integer","nullable":true},"subject_name":{"type":"string","nullable":true},"phase":{"type":"integer","nullable":true}}}},"other":{"type":"string","nullable":true}}},"specified_concepts":{"type":"array","description":"Specified concepts for the unit (MYP, disabled by default).","nullable":true,"items":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"subject_id":{"type":"integer","nullable":true},"subject_name":{"type":"string","nullable":true},"phase":{"type":"integer","nullable":true}}}},"statement_of_inquiry":{"type":"string","description":"Statement of inquiry (HTML).","nullable":true},"conceptual_understandings":{"type":"string","description":"Conceptual understandings (HTML).","nullable":true},"contextual_lens":{"type":"object","description":"Contextual lens scope with text per scope.","nullable":true,"additionalProperties":{"type":"string"}},"community_engagement":{"type":"object","description":"Community engagement with selected options and comments.","nullable":true,"properties":{"selected":{"type":"array","items":{"type":"string"}},"principled_action_comment":{"type":"string","nullable":true},"learning_process_comment":{"type":"string","nullable":true}}},"approaches_to_learning":{"type":"object","description":"Approaches to learning tree structure with ATL details.","nullable":true,"properties":{"atls":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"children":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"}}}}}}},"atl_details":{"type":"string","nullable":true}}},"criteria":{"type":"object","description":"Assessment criteria grouped by subject and level with description.","nullable":true,"properties":{"criteria":{"type":"array","items":{"type":"object","properties":{"subject_id":{"type":"integer","nullable":true},"subject_name":{"type":"string","nullable":true},"level":{"type":"string","description":"'hl' or 'sl'"},"criteria":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"children":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"}}}}}}}}}},"criteria_description":{"type":"string","nullable":true}}},"global_contexts":{"type":"object","description":"Global contexts with explorations (MYP only).","nullable":true,"properties":{"unit_global_contexts":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"exploration_to_develop":{"type":"array","items":{"type":"string"}},"subjects":{"type":"array","items":{"type":"string"}}}}}}},"transdisciplinary_theme":{"type":"object","description":"PYP transdisciplinary theme with selected descriptions.","nullable":true,"properties":{"id":{"type":"integer"},"title":{"type":"string"},"list":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"}}}}}},"standards":{"type":"object","description":"Standards with core_standards and curriculum standards.","nullable":true,"properties":{"core_standards":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"children":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"}}}}}}},"standards":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"kind":{"type":"string"},"atlas_grade":{"type":"object","nullable":true,"properties":{"id":{"type":"integer"},"name":{"type":"string"}}},"children":{"type":"array","items":{"type":"object"}}}}}}},"academic_integrity":{"type":"string","description":"Academic integrity (HTML).","nullable":true},"agency":{"type":"string","description":"Agency (HTML).","nullable":true},"action":{"type":"string","description":"Action (HTML).","nullable":true},"student_self_assessment":{"type":"string","description":"Student self assessment (HTML).","nullable":true},"success_criteria":{"type":"string","description":"Success criteria (HTML).","nullable":true},"ongoing_assessment":{"type":"string","description":"Ongoing assessment (HTML).","nullable":true},"attitudes":{"type":"array","description":"Attitudes (comma-separated values split into array).","nullable":true,"items":{"type":"string"}},"aims":{"type":"array","description":"Aims grouped by year and subject with ancestry tree.","nullable":true,"items":{"type":"object","properties":{"year":{"type":"integer","nullable":true},"subjects":{"type":"array","items":{"type":"object","properties":{"subject_id":{"type":"integer","nullable":true},"subject_name":{"type":"string","nullable":true},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"children":{"type":"array","items":{"type":"object"}}}}}}}}}}},"objectives":{"type":"array","description":"Objectives grouped by year and subject with ancestry tree.","nullable":true,"items":{"type":"object","properties":{"year":{"type":"integer","nullable":true},"subjects":{"type":"array","items":{"type":"object","properties":{"subject_id":{"type":"integer","nullable":true},"subject_name":{"type":"string","nullable":true},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"children":{"type":"array","items":{"type":"object"}}}}}}}}}}},"syllabus":{"type":"object","description":"Syllabus tree structure.","nullable":true,"properties":{"syllabuses":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"children":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"}}}}}}}}},"scope_sequence":{"type":"array","description":"Scope and sequence grouped by subject, phase/grade, strand, and kind.","nullable":true,"items":{"type":"object","properties":{"subject_id":{"type":"integer","nullable":true},"subject_name":{"type":"string","nullable":true},"phases_or_grades":{"type":"array","items":{"type":"object","properties":{"phase_or_grade":{"type":"string","nullable":true},"strands":{"type":"array","items":{"type":"object","properties":{"strand_id":{"type":"integer"},"strand_name":{"type":"string"},"kinds":{"type":"object","additionalProperties":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"expectation":{"type":"string"},"children":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"expectation":{"type":"string"}}}}}}}}}}}}}}}}},"created_at":{"type":"string","description":"Created date."},"updated_at":{"type":"string","description":"Updated date."}}},"Meta":{"type":"object","description":"Pagination metadata included in all list (index) responses.","properties":{"current_page":{"type":"integer","description":"The page number of the current result set, starting from 1."},"total_pages":{"type":"integer","description":"The total number of pages available for this query."},"total_count":{"type":"integer","description":"The total number of records matching the query across all pages."},"per_page":{"type":"integer","description":"The number of records returned per page. Defaults to 100; can be overridden with the per_page query parameter (max 200)."}}}}},"paths":{"/v2p0/units":{"get":{"summary":"Get all Units","operationId":"listUnits","tags":["Units"],"description":"This endpoint retrieves all unit plans. It returns unit details including title, description, pedagogical content, and associated class IDs.","parameters":[{"name":"modified_since","in":"query","description":"A timestamp to filter the modification date of results.","required":false,"schema":{"type":"string"}},{"name":"page","in":"query","description":"An integer defining which page to display.","required":false,"schema":{"type":"string"}},{"name":"per_page","in":"query","description":"An integer defining the number of records to display per page.","required":false,"schema":{"type":"string"}},{"name":"archived","in":"query","description":"A boolean that, if set to True, returns only archived units.","required":false,"schema":{"type":"boolean"}},{"name":"class_ids","in":"query","description":"A comma-separated list of class IDs to filter units by.","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"units":{"type":"array","items":{"$ref":"#/components/schemas/Unit"}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}}}}}}}
```

## Get a Unit

> This endpoint retrieves a single unit plan as specified by ID. It returns unit details including pedagogical content and associated class IDs.

```json
{"openapi":"3.0.3","info":{"title":"API V2P0","version":"v2p0"},"tags":[{"name":"Units","description":"A Unit is a unit plan that organizes curriculum delivery within a class, containing pedagogical content such as learning objectives, assessments, and resources."}],"servers":[{"url":"https://api.managebac.com","description":"CA ManageBac API server."},{"url":"https://api.managebac.cn","description":"CN ManageBac API server."},{"url":"https://api.us.managebac.com","description":"US1 ManageBac API server."},{"url":"https://api.managebac.us","description":"US2 ManageBac API server."},{"url":"https://api.managebactest.com","description":"UAT ManageBac API server."},{"url":"https://{Host}","variables":{"Host":{"default":"api.devel.managebac.com","enum":["api.devel.managebac.com","api-faria.devel.managebac.com","api.managebac.dev"]}}}],"security":[{"bearerAuth":[]},{"authTokenQuery":[]},{"authTokenHeader":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"OAuth 2.0 Bearer token obtained via client credentials grant. Pass the token in the Authorization header as `Bearer <token>`."},"authTokenQuery":{"type":"apiKey","name":"auth_token","in":"query","description":"Your V2 API authentication token may be passed in the parameters. To protect your key, use [environment variables](https://cloud.google.com/docs/authentication/api-keys#securing_an_api_key)."},"authTokenHeader":{"type":"apiKey","name":"auth-token","in":"header","description":"Your V2 API authentication token may be passed in the header. To protect your key, use [environment variables](https://cloud.google.com/docs/authentication/api-keys#securing_an_api_key)."}},"schemas":{"Unit":{"type":"object","properties":{"id":{"type":"integer","description":"Unique ID in ManageBac."},"title":{"type":"string","description":"Unit title."},"description":{"type":"string","description":"Unit description.","nullable":true},"archived":{"type":"boolean","description":"Whether the unit is archived."},"idu_unit":{"type":"boolean","description":"Whether this is an interdisciplinary unit.","nullable":true},"month":{"type":"integer","description":"Starting month number (1-12).","nullable":true},"week":{"type":"integer","description":"Starting week within the month.","nullable":true},"duration_in_weeks":{"type":"integer","description":"Duration in weeks.","nullable":true},"hours":{"type":"integer","description":"Number of hours.","nullable":true},"sl":{"type":"boolean","description":"Whether the unit is for Standard Level.","nullable":true},"hl":{"type":"boolean","description":"Whether the unit is for Higher Level.","nullable":true},"language_level":{"type":"string","description":"Language level.","nullable":true},"language_b_phases":{"type":"string","description":"Language B phases.","nullable":true},"subject":{"type":"object","description":"Subject information.","nullable":true,"properties":{"id":{"type":"integer","description":"Subject ID."},"name":{"type":"string","description":"Subject name."}}},"grade":{"type":"string","description":"Grade name."},"grade_number":{"type":"integer","description":"Grade number."},"class_ids":{"type":"array","description":"IDs of classes associated with this unit.","items":{"type":"integer"}},"start_date":{"type":"string","format":"date","description":"Computed start date of the unit.","nullable":true},"end_date":{"type":"string","format":"date","description":"Computed end date of the unit.","nullable":true},"central_idea":{"type":"string","description":"Central idea of the unit.","nullable":true},"guiding_questions":{"type":"object","description":"Guiding questions for the unit.","nullable":true,"properties":{"inquiry_questions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"line_of_inquiry":{"type":"string","nullable":true},"question":{"type":"string","nullable":true},"subjects":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"}}}},"labels":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"}}}}}}}}},"formative_assessment":{"type":"string","description":"Formative assessment details.","nullable":true},"summative_assessment":{"type":"string","description":"Summative assessment details.","nullable":true},"peer_self_assessment":{"type":"string","description":"Peer and self assessment details.","nullable":true},"standardization_and_moderation":{"type":"string","description":"Standardization and moderation details.","nullable":true},"methods":{"type":"string","description":"Methods used.","nullable":true},"prior_learning_experiences":{"type":"string","description":"Prior learning experiences.","nullable":true},"student_expectations":{"type":"string","description":"Student expectations.","nullable":true},"pedagogical_approaches":{"type":"object","description":"Pedagogical approaches.","nullable":true,"properties":{"selected":{"type":"array","items":{"type":"string"}},"text":{"type":"string","nullable":true}}},"teaching_strategies":{"type":"string","description":"Teaching strategies used.","nullable":true},"feedback":{"type":"string","description":"Feedback details.","nullable":true},"dispositions":{"type":"string","description":"Dispositions.","nullable":true},"international_mindedness":{"type":"string","description":"International mindedness.","nullable":true},"academic_honesty":{"type":"string","description":"Academic honesty.","nullable":true},"information_communication_technology":{"type":"string","description":"Information and communication technology.","nullable":true},"language_and_literacy_development":{"type":"object","description":"Language and literacy development.","nullable":true,"properties":{"options":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"text":{"type":"string","nullable":true}}},"cross_curricular_links":{"type":"object","description":"Cross-curricular links.","nullable":true,"properties":{"options":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"text":{"type":"string","nullable":true}}},"co_curricular_links":{"type":"object","description":"Co-curricular links.","nullable":true,"properties":{"options":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"text":{"type":"string","nullable":true}}},"differentiation":{"type":"object","description":"Differentiation details.","nullable":true,"properties":{"options":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"text":{"type":"string","nullable":true}}},"content":{"type":"string","description":"Content details.","nullable":true},"skills":{"type":"string","description":"Skills details.","nullable":true},"learning_process":{"type":"string","description":"Learning process details.","nullable":true},"metacognition":{"type":"object","description":"Metacognition details.","nullable":true,"properties":{"options":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"text":{"type":"string","nullable":true}}},"unit_activities":{"type":"array","description":"Unit activities.","nullable":true,"items":{"type":"object","properties":{"id":{"type":"integer"},"title":{"type":"string"}}}},"support_materials":{"type":"object","description":"Support materials.","nullable":true,"properties":{"options":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"text":{"type":"string","nullable":true}}},"concepts":{"type":"string","description":"Concepts.","nullable":true},"misunderstandings":{"type":"string","description":"Misunderstandings.","nullable":true},"transfer_goals":{"type":"string","description":"Transfer goals.","nullable":true},"lines_of_inquiry":{"type":"array","description":"Lines of inquiry for the unit (PYP only).","nullable":true,"items":{"type":"object","properties":{"id":{"type":"integer"},"line":{"type":"string"}}}},"student_questions":{"type":"array","description":"Student questions for the unit (PYP only).","nullable":true,"items":{"type":"object","properties":{"id":{"type":"integer"},"title":{"type":"string"}}}},"teacher_questions":{"type":"array","description":"Teacher questions for the unit (PYP only).","nullable":true,"items":{"type":"object","properties":{"id":{"type":"integer"},"title":{"type":"string"}}}},"learner_profiles":{"type":"array","description":"Learner profiles associated with the unit.","nullable":true,"items":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"}}}},"key_concepts":{"type":"object","description":"Key concepts and unit key concepts for the unit.","nullable":true,"properties":{"key_concepts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"concept":{"type":"string"}}}},"unit_key_concepts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"kind":{"type":"string","description":"Concept kind (e.g. form, function, causation).","nullable":true},"explanation_related_concept":{"type":"string","nullable":true}}}}}},"related_concepts":{"type":"object","description":"Related concepts for the unit (MYP only).","nullable":true,"properties":{"related_concepts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"subject_id":{"type":"integer","nullable":true},"subject_name":{"type":"string","nullable":true},"phase":{"type":"integer","nullable":true}}}},"other":{"type":"string","nullable":true}}},"specified_concepts":{"type":"array","description":"Specified concepts for the unit (MYP, disabled by default).","nullable":true,"items":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"subject_id":{"type":"integer","nullable":true},"subject_name":{"type":"string","nullable":true},"phase":{"type":"integer","nullable":true}}}},"statement_of_inquiry":{"type":"string","description":"Statement of inquiry (HTML).","nullable":true},"conceptual_understandings":{"type":"string","description":"Conceptual understandings (HTML).","nullable":true},"contextual_lens":{"type":"object","description":"Contextual lens scope with text per scope.","nullable":true,"additionalProperties":{"type":"string"}},"community_engagement":{"type":"object","description":"Community engagement with selected options and comments.","nullable":true,"properties":{"selected":{"type":"array","items":{"type":"string"}},"principled_action_comment":{"type":"string","nullable":true},"learning_process_comment":{"type":"string","nullable":true}}},"approaches_to_learning":{"type":"object","description":"Approaches to learning tree structure with ATL details.","nullable":true,"properties":{"atls":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"children":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"}}}}}}},"atl_details":{"type":"string","nullable":true}}},"criteria":{"type":"object","description":"Assessment criteria grouped by subject and level with description.","nullable":true,"properties":{"criteria":{"type":"array","items":{"type":"object","properties":{"subject_id":{"type":"integer","nullable":true},"subject_name":{"type":"string","nullable":true},"level":{"type":"string","description":"'hl' or 'sl'"},"criteria":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"children":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"}}}}}}}}}},"criteria_description":{"type":"string","nullable":true}}},"global_contexts":{"type":"object","description":"Global contexts with explorations (MYP only).","nullable":true,"properties":{"unit_global_contexts":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"exploration_to_develop":{"type":"array","items":{"type":"string"}},"subjects":{"type":"array","items":{"type":"string"}}}}}}},"transdisciplinary_theme":{"type":"object","description":"PYP transdisciplinary theme with selected descriptions.","nullable":true,"properties":{"id":{"type":"integer"},"title":{"type":"string"},"list":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"}}}}}},"standards":{"type":"object","description":"Standards with core_standards and curriculum standards.","nullable":true,"properties":{"core_standards":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"children":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"}}}}}}},"standards":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"kind":{"type":"string"},"atlas_grade":{"type":"object","nullable":true,"properties":{"id":{"type":"integer"},"name":{"type":"string"}}},"children":{"type":"array","items":{"type":"object"}}}}}}},"academic_integrity":{"type":"string","description":"Academic integrity (HTML).","nullable":true},"agency":{"type":"string","description":"Agency (HTML).","nullable":true},"action":{"type":"string","description":"Action (HTML).","nullable":true},"student_self_assessment":{"type":"string","description":"Student self assessment (HTML).","nullable":true},"success_criteria":{"type":"string","description":"Success criteria (HTML).","nullable":true},"ongoing_assessment":{"type":"string","description":"Ongoing assessment (HTML).","nullable":true},"attitudes":{"type":"array","description":"Attitudes (comma-separated values split into array).","nullable":true,"items":{"type":"string"}},"aims":{"type":"array","description":"Aims grouped by year and subject with ancestry tree.","nullable":true,"items":{"type":"object","properties":{"year":{"type":"integer","nullable":true},"subjects":{"type":"array","items":{"type":"object","properties":{"subject_id":{"type":"integer","nullable":true},"subject_name":{"type":"string","nullable":true},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"children":{"type":"array","items":{"type":"object"}}}}}}}}}}},"objectives":{"type":"array","description":"Objectives grouped by year and subject with ancestry tree.","nullable":true,"items":{"type":"object","properties":{"year":{"type":"integer","nullable":true},"subjects":{"type":"array","items":{"type":"object","properties":{"subject_id":{"type":"integer","nullable":true},"subject_name":{"type":"string","nullable":true},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"children":{"type":"array","items":{"type":"object"}}}}}}}}}}},"syllabus":{"type":"object","description":"Syllabus tree structure.","nullable":true,"properties":{"syllabuses":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"children":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"}}}}}}}}},"scope_sequence":{"type":"array","description":"Scope and sequence grouped by subject, phase/grade, strand, and kind.","nullable":true,"items":{"type":"object","properties":{"subject_id":{"type":"integer","nullable":true},"subject_name":{"type":"string","nullable":true},"phases_or_grades":{"type":"array","items":{"type":"object","properties":{"phase_or_grade":{"type":"string","nullable":true},"strands":{"type":"array","items":{"type":"object","properties":{"strand_id":{"type":"integer"},"strand_name":{"type":"string"},"kinds":{"type":"object","additionalProperties":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"expectation":{"type":"string"},"children":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"expectation":{"type":"string"}}}}}}}}}}}}}}}}},"created_at":{"type":"string","description":"Created date."},"updated_at":{"type":"string","description":"Updated date."}}}}},"paths":{"/v2p0/units/{id}":{"get":{"summary":"Get a Unit","operationId":"getUnitByID","tags":["Units"],"description":"This endpoint retrieves a single unit plan as specified by ID. It returns unit details including pedagogical content and associated class IDs.","parameters":[{"name":"id","in":"path","description":"Unique identifier for unit.","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"unit":{"$ref":"#/components/schemas/Unit"}}}}}}}}}}}
```