> ## Documentation Index
> Fetch the complete documentation index at: https://docs.crazygoldfish.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GET - Lesson Plan Finalize Metadata

> 
This API allows authenticated users to retrieve the status and details of lesson plan finalization for a specific lesson plan.

**How to Use:**
 1. Call this endpoint with the lesson plan ID as the path parameter.
 2. The API checks the finalize metadata process for that lesson plan and returns current status plus relevant details.
 3. On success, the response includes pending, in-progress, or completed state and related output details.

**Example Scenario:**
A teacher checks finalization status for a lesson plan.
- The request is validated with the provided lesson plan ID.
- The system returns current status and processing details.
- The teacher tracks progress and reviews finalization results.


## When to use this endpoint

Use this endpoint whenever downstream systems or dashboards need to **confirm that lesson plan metadata has been fully finalized** before generating lesson plans or worksheets:

* Lesson Plan Builder UI showing **status chips** (Pending, In Progress, Completed) for each plan.
* Workflow engines that must wait for **finalized objectives and outcomes** before triggering content generation.
* Monitoring tools that surface **stalled or failed finalize runs** for operator review.

It is typically called after initializing metadata and before invoking instructional framework or enrichment APIs.

## Related endpoints

* [POST - Initialize Lesson Plan Metadata](/api-reference/endpoint/lesson-plan/v1-meta-data-post)
* [GET - Lesson Plan Metadata](/api-reference/endpoint/lesson-plan/v1-meta-data-get)
* [POST - Lesson Plan Finalize Metadata](/api-reference/endpoint/lesson-plan/v1-finalize-metadata-post)


## OpenAPI

````yaml GET /lesson-plan/v1/finalize-metadata/{lesson_plan_id}
openapi: 3.0.1
info:
  title: Evaluation Report API
  description: An API for retrieving evaluation reports.
  version: 1.0.0
servers:
  - url: https://api-staging.crazygoldfish.com
    description: SandBox endpoint
  - url: https://api.crazygoldfish.com
    description: Prod End Point
security: []
paths:
  /lesson-plan/v1/finalize-metadata/{lesson_plan_id}:
    get:
      summary: Retrieve the alignment of a lesson plan by its ID.
      operationId: getLessonPlanAlignment
      parameters:
        - name: lesson_plan_id
          in: path
          required: true
          description: The UUID of the lesson plan.
          schema:
            type: string
            format: uuid
            example: 4340132f-50fa-4877-9ffa-e9b7ee59d51f
      responses:
        '200':
          description: Lesson plan alignment found and returned.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    description: Full lesson plan details including alignment.
                    properties:
                      id:
                        type: string
                        format: uuid
                        description: Unique identifier of the lesson plan.
                      board:
                        type: object
                        description: >-
                          Details about the board associated with the lesson
                          plan.
                        properties:
                          id:
                            type: string
                            format: uuid
                            description: Unique identifier of the board.
                          name:
                            type: string
                            description: Name of the board.
                      grade:
                        type: object
                        description: >-
                          Details about the grade associated with the lesson
                          plan.
                        properties:
                          id:
                            type: string
                            format: uuid
                            description: Unique identifier of the grade.
                          name:
                            type: string
                            description: Name of the grade.
                      section:
                        type: string
                        description: Section of the lesson plan (optional).
                      subject:
                        type: object
                        description: >-
                          Details about the subject associated with the lesson
                          plan.
                        properties:
                          id:
                            type: string
                            format: uuid
                            description: Unique identifier of the subject.
                          name:
                            type: string
                            description: Name of the subject.
                      status:
                        type: string
                        description: Status of the lesson plan.
                      duration_minutes:
                        type: integer
                        description: Duration of the lesson plan in minutes.
                      topic:
                        type: string
                        description: Topic of the lesson plan.
                      documents:
                        type: array
                        description: List of document URLs associated with the lesson plan.
                        items:
                          type: string
                          format: uri
                      audio:
                        type: string
                        description: Optional audio resource URL.
                      subject_matter:
                        type: object
                        description: Subject matter details of the lesson plan.
                        properties:
                          topics_to_be_covered:
                            type: object
                            description: Topics to be covered in the lesson plan.
                            properties:
                              topic:
                                type: object
                                properties:
                                  ai_recommendations:
                                    type: array
                                    items:
                                      type: string
                                  additional_recommendations:
                                    type: array
                                    items:
                                      type: string
                          key_concepts_and_subconcepts:
                            type: object
                            description: >-
                              Key concepts and subconcepts related to the lesson
                              plan.
                            properties:
                              concepts:
                                type: object
                                properties:
                                  ai_recommendations:
                                    type: array
                                    items:
                                      type: string
                                  additional_recommendations:
                                    type: array
                                    items:
                                      type: string
                          prerequisite_knowledge:
                            type: object
                            description: >-
                              Prerequisite knowledge required for the lesson
                              plan.
                            properties:
                              prerequisite:
                                type: object
                                properties:
                                  ai_recommendations:
                                    type: array
                                    items:
                                      type: string
                                  additional_recommendations:
                                    type: array
                                    items:
                                      type: string
                      learning_standards:
                        type: object
                        description: Learning standards associated with the lesson plan.
                        properties:
                          learning_outcomes:
                            type: object
                            properties:
                              outcomes:
                                type: object
                                properties:
                                  ai_recommendations:
                                    type: array
                                    items:
                                      type: string
                                  additional_recommendations:
                                    type: array
                                    items:
                                      type: string
                          smart_learning_objectives:
                            type: object
                            properties:
                              objects:
                                type: object
                                properties:
                                  ai_recommendations:
                                    type: array
                                    items:
                                      type: string
                                  additional_recommendations:
                                    type: array
                                    items:
                                      type: string
                          competencies:
                            type: object
                            properties:
                              competency_list:
                                type: array
                                items:
                                  type: object
                                  properties:
                                    name:
                                      type: string
                                    description:
                                      type: string
                      alignment:
                        type: object
                        description: Alignment details of the lesson plan.
                        properties:
                          materials_options:
                            type: array
                            description: List of material recommendation sets.
                            items:
                              type: array
                              items:
                                type: object
                                properties:
                                  ai_recommendations:
                                    type: array
                                    items:
                                      type: object
                                      properties:
                                        name:
                                          type: string
                                        description:
                                          type: string
                                  additional_recommendations:
                                    type: array
                                    items:
                                      type: object
                                      properties:
                                        name:
                                          type: string
                                        description:
                                          type: string
                          instructional_strategies_options:
                            type: array
                            description: List of instructional strategy sets.
                            items:
                              type: array
                              items:
                                type: object
                                properties:
                                  ai_recommendations:
                                    type: array
                                    items:
                                      type: object
                                      properties:
                                        name:
                                          type: string
                                        description:
                                          type: string
                                  additional_recommendations:
                                    type: array
                                    items:
                                      type: object
                                      properties:
                                        name:
                                          type: string
                                        description:
                                          type: string
                          instructional_blocks:
                            type: object
                            description: >-
                              Instructional blocks with components, questions,
                              and durations.
                            properties:
                              introduction:
                                type: object
                              development:
                                type: object
                              guided_practice:
                                type: object
                              independent_practice:
                                type: object
                              closure:
                                type: object
                              summative_assessment:
                                type: object
              example:
                data:
                  id: 658fcb13-0304-46cd-8c3d-0776ec4506f8
                  board:
                    id: 087c80b0-ac25-40ee-8657-28b694882ba8
                    name: CBSE
                  grade:
                    id: 65955148-e106-461b-a9a6-e0c3294f6734
                    name: Grade 10
                  section: null
                  subject:
                    id: abf49127-253c-4dc9-9bf5-eb66360e5592
                    name: Mathematics
                  status: Completed
                  duration_minutes: 50
                  topic: Real Numbers
                  documents: []
                  audio: null
                  subject_matter:
                    topics_to_be_covered:
                      topic:
                        ai_recommendations:
                          - >-
                            Include a thorough explanation and proof of the
                            Euclid's division algorithm with examples to
                            reinforce understanding.
                          - >-
                            Cover the Fundamental Theorem of Arithmetic
                            emphasizing the uniqueness of prime factorization
                            and applications in problem-solving.
                          - >-
                            Incorporate proofs of irrationality for numbers like
                            √2, √3, and sums involving irrational numbers to
                            strengthen conceptual clarity.
                        additional_recommendations:
                          - >-
                            Use number line visualizations to help locate
                            irrational numbers effectively.
                          - >-
                            Design exercises proving irrationality and
                            divisibility properties to enhance analytical
                            skills.
                    key_concepts_and_subconcepts:
                      concepts:
                        ai_recommendations:
                          - >-
                            Euclid's division algorithm: divisibility of
                            integers
                          - >-
                            Fundamental Theorem of Arithmetic: uniqueness of
                            prime factorization
                          - 'Proofs of irrationality: √2 is irrational'
                          - 'Proofs of irrationality: √3 is irrational'
                          - 'Proofs of irrationality: 3 + 2√5 is irrational'
                        additional_recommendations:
                          - >-
                            Number line visualizations: locating irrational
                            numbers (0 to 2 segment)
                          - >-
                            Exercises: proving irrationality of 5 and sums
                            involving irrational numbers
                          - 'Use of proofs by contradiction: example with √2'
                          - >-
                            Properties of divisibility: if 2 divides a^2, then 2
                            divides a (Theorem 1.2)
                    prerequisite_knowledge:
                      prerequisite:
                        ai_recommendations:
                          - >-
                            Review the basics of integers, divisibility, and
                            factors introduced in earlier grades to understand
                            Euclid's division algorithm effectively.
                          - >-
                            Understand the concept of rational and irrational
                            numbers, including their definitions and examples
                            from Class IX.
                          - >-
                            Familiarize with number line representation,
                            especially locating rational and irrational numbers
                            to visualize abstract concepts.
                        additional_recommendations:
                          - >-
                            Practice prime factorization and its uniqueness to
                            grasp the Fundamental Theorem of Arithmetic.
                          - >-
                            Develop skills in basic proof techniques, such as
                            contradiction, which are essential for proving
                            irrationality.
                          - >-
                            Use exercises involving divisibility and
                            irrationality proofs to build analytical reasoning
                            necessary for the topic.
                  learning_standards:
                    learning_outcomes:
                      outcomes:
                        ai_recommendations:
                          - >-
                            generalises properties of numbers and relations
                            among them studied earlier to evolve results, such
                            as, Euclid’s division algorithm, Fundamental Theorem
                            of Arithmetic and applies them to solve problems
                            related to real life contexts.
                        additional_recommendations: []
                    smart_learning_objectives:
                      objects:
                        ai_recommendations:
                          - >-
                            Students will recall and explain the properties of
                            numbers and the relations among them studied
                            earlier, demonstrating understanding within a
                            50-minute session. (Remembering)
                          - >-
                            Students will analyze numbers to apply Euclid’s
                            division algorithm in solving given mathematical
                            problems within 50 minutes. (Analyzing)
                          - >-
                            Students will apply the Fundamental Theorem of
                            Arithmetic to factorize integers and solve related
                            problems in real-life contexts during a 50-minute
                            exercise. (Applying)
                          - >-
                            Students will evaluate problem scenarios and
                            construct solutions using properties of numbers,
                            Euclid’s division algorithm, and the Fundamental
                            Theorem of Arithmetic within a 50-minute timeframe.
                            (Evaluating)
                        additional_recommendations: []
                    competencies:
                      competency_list:
                        - name: CG-1
                          description: >-
                            C-1.1: Develops understanding of numbers, including
                            the set of real numbers and its properties.
                        - name: CG-3
                          description: >-
                            C-3.1: States and motivates/proves remainder
                            theorem, factor theorem, and division algorithm.
                        - name: CG-3
                          description: >-
                            C-3.2: Models and solves contextualised problems
                            using equations (e.g., simultaneous linear equations
                            in two variables or single polynomial equations) and
                            draws conclusions about a situation being modelled.
                        - name: CG-4
                          description: >-
                            C-4.4: Understands the irrationality of π, the best
                            approximations to π discovered over human history,
                            and the first exact formula (infinite series) for π
                            given by Madhava.
                  alignment:
                    materials_options:
                      - - ai_recommendations:
                            - name: Detailed Textbook Sections with Examples
                              description: >-
                                Use detailed textbook explanations and proofs to
                                reinforce core concepts through examples.
                            - name: Number Line Visualization Tools
                              description: >-
                                Incorporate visual aids for locating irrational
                                numbers to build conceptual understanding.
                            - name: Interactive Proof Worksheets
                              description: >-
                                Provide worksheets focusing on proofs of
                                irrationality and divisibility to enhance
                                analytical skills.
                          additional_recommendations:
                            - name: Prime Factorization Charts
                              description: >-
                                Display prime factorization charts to illustrate
                                unique factorization clearly.
                            - name: Divisibility Properties Handouts
                              description: >-
                                Supplement lessons with handouts explaining
                                divisibility properties for reference.
                    instructional_strategies_options:
                      - - ai_recommendations:
                            - name: Inquiry-Based Learning
                              description: >-
                                Engage students in exploring proofs and
                                algorithms through guided questioning and
                                discovery.
                            - name: Collaborative Group Work
                              description: >-
                                Use group activities to foster discussion, peer
                                explanation, and engagement with complex proofs.
                            - name: Modeling & Think-Aloud
                              description: >-
                                Demonstrate problem-solving and proofs while
                                verbalizing thought processes for clarity.
                          additional_recommendations:
                            - name: Use of Formative Quizzes
                              description: >-
                                Integrate quick quizzes to check understanding
                                and guide pacing.
                            - name: Visual Aids Integration
                              description: >-
                                Strategically use diagrams and number lines
                                during explanation phases to support
                                comprehension.
                    instructional_blocks:
                      introduction:
                        component_options:
                          - name: Warm-up Discussion on Number Properties
                            description: >-
                              Activate prior knowledge about integers,
                              divisibility, rational and irrational numbers.
                          - name: Concept Mapping Activity
                            description: >-
                              Create concept maps linking divisibility,
                              factorization, and irrational numbers.
                        formative_questions:
                          - >-
                            What is the difference between rational and
                            irrational numbers?
                          - >-
                            How can we recognize if a number is divisible by
                            another?
                        duration: 7
                      development:
                        component_options:
                          - name: Explain Euclid's Division Algorithm with Examples
                            description: >-
                              Demonstrate algorithm with step-by-step proofs and
                              sample exercises.
                          - name: Discuss Fundamental Theorem of Arithmetic
                            description: >-
                              Highlight uniqueness of prime factorization and
                              its applications in problem-solving.
                        formative_questions:
                          - >-
                            Can you explain the steps involved in Euclid's
                            division algorithm?
                          - Why is the prime factorization of an integer unique?
                        duration: 12
                      guided_practice:
                        component_options:
                          - name: Work Through Proofs of Irrationality
                            description: >-
                              Guide students in step-by-step proofs for √2, √3,
                              and sums involving irrational numbers.
                          - name: Number Line Activities
                            description: >-
                              Have students locate irrational numbers between 0
                              and 2 using number line models.
                        formative_questions:
                          - >-
                            How does the proof by contradiction show that √2 is
                            irrational?
                          - >-
                            Where would 3 + 2√5 be placed on the number line
                            segment from 0 to 2?
                        duration: 10
                      independent_practice:
                        component_options:
                          - name: >-
                              Individual Exercises on Divisibility and
                              Factorization
                            description: >-
                              Students solve problems applying Euclid's
                              algorithm and prime factorization.
                          - name: Practice Proofs on Irrationality
                            description: >-
                              Write proofs for irrationality of different
                              numbers and sums independently.
                        formative_questions:
                          - If 2 divides a², what can we conclude about 'a'?
                          - >-
                            Try to prove that √5 is irrational using
                            contradiction.
                        duration: 12
                      closure:
                        component_options:
                          - name: Summarize Key Concepts
                            description: >-
                              Review Euclid's algorithm, fundamental theorem,
                              and irrationality proofs.
                          - name: Reflective Discussion
                            description: >-
                              Discuss learning challenges and conceptual
                              understanding achieved.
                        formative_questions:
                          - What is one key takeaway about prime factorization?
                          - >-
                            How does understanding irrational numbers help in
                            real life?
                        duration: 5
                      summative_assessment:
                        component_options:
                          - name: >-
                              Written Test on Euclid's Algorithm and
                              Factorization
                            description: >-
                              Assess understanding of algorithms, factorization,
                              and related proofs through written problems.
                          - name: Proof Construction Assignment
                            description: >-
                              Students compose detailed proofs for irrationality
                              concepts covered.
                          - name: Problem-Solving Project
                            description: >-
                              Apply concepts to real-life contexts involving
                              divisibility and irrational numbers.
                          - name: Oral Presentation
                            description: >-
                              Evaluate students' ability to explain concepts and
                              proofs clearly and confidently.
                        formative_questions: []
                        duration: 4
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````