> ## 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.

# v1/toefl/evaluation/{id_}

> Retrieve a specific evaluation report using its unique identifier (ID). Clients can access past evaluations or reference specific reports by providing the evaluation ID. 



## OpenAPI

````yaml GET /v1/toefl/evaluation/{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:
  /v1/toefl/evaluation/{id_}:
    get:
      summary: Retrieve Evaluation Report
      description: >-
        Allows B2B clients to retrieve a specific evaluation report using its
        unique identifier (ID).
      parameters:
        - name: id_
          in: path
          required: true
          schema:
            type: string
            example: '123456789'
          description: Unique identifier of the evaluation report.
        - name: accept
          in: header
          required: true
          schema:
            type: string
            enum:
              - application/json
            default: application/json
      responses:
        '200':
          description: Successful response
          headers:
            Content-Type:
              schema:
                type: string
                example: application/json
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    evaluation:
                      type: object
                      properties:
                        evaluation_id:
                          type: string
                          example: bbb264b6-4780-4095-a973-25daa5e8545f
                        client_id:
                          type: string
                          example: '1'
                        institution_id:
                          type: string
                          example: inst_456
                        teacher_id:
                          type: string
                          example: string
                        parent_id:
                          type: string
                          example: string
                        evaluation_data:
                          type: object
                          properties:
                            student_id:
                              type: string
                              example: '123'
                            test_type:
                              type: string
                              example: IB
                            student_name:
                              type: string
                              example: John Doe
                            image_urls:
                              type: array
                              items:
                                type: string
                              example:
                                - string
                            evaluation_text:
                              type: array
                              items:
                                type: object
                                properties:
                                  question_text:
                                    type: string
                                    example: >-
                                      Write your personal opinion on the
                                      academic topic. answer the question based
                                      on the discussion.Minimum of 100 words 
                                       Academic Discussion Professor John: Many universities offer online courses as an alternative to traditional classroom-based learning. Do you think online courses provide the same quality of education as traditional classroom-based learning? Why or why not? Use examples and details in your response.Jason: I believe online courses can provide a similar quality of education as traditional classroom-based learning. With advanced technology and interactive platforms, students can access high-quality lectures, engage in virtual discussions, and submit assignments online, often at their own pace and convenience. So, personally, I think that online courses provide the same quality of education as traditional classroom-based learning while being more accessible. 
                                       Anna: In my opinion, online courses offer convenience and flexibility, but they often fall short of delivering the same quality of education as traditional classroom-based learning. In a traditional classroom setting, students can actively engage in discussions, ask questions, and receive immediate feedback from professors, which facilitates deeper understanding and retention of the material. While online courses offer certain advantages, such as accessibility, they often lack the personalized attention and immersive learning experience provided by traditional classroom-based learning.
                                  answer_text:
                                    type: string
                                    example: >-
                                      In fact, online courses could provide the
                                      same quality of education similar to the
                                      one a student will experience in a
                                      classroom.But it all depends on how they
                                      are designed and delivered. eg
                                      universities employing advanced technology
                                      with interactive platforms are able to
                                      offer quality lectures, virtual
                                      discussions, and online assignments. These
                                      ingredients allow learning at a
                                      self-determined pace which is essential
                                      for people who have other commitments,
                                      such as work or family. Moreover, the
                                      flexibility and accessibilities of online
                                      courses could let more types of students
                                      be involved in the learning process,
                                      enriching it for everyone. For example,
                                      suppose some student lives in a remote
                                      area and is unable to commute to any
                                      university. With the help of online
                                      courses, he or she can obtain top-class
                                      education. At the same time, it is also
                                      necessary to be aware of the negative
                                      side, like the impossibility of immediate
                                      feedback and interaction with professors
                                      and peers, which is more available in a
                                      traditional class.
                                  question_type:
                                    type: string
                                    example: TF-IB-W-02
                                  question_multimedia_url:
                                    type: string
                                    example: string
                                  answer_multimedia_url:
                                    type: string
                                    example: 'null'
                                  question_id:
                                    type: string
                                    example: '2'
                                  question_number:
                                    type: string
                                    example: '2'
                                  question_section:
                                    type: string
                                    example: writing
                                  answer_objective_evaluation:
                                    type: object
                                    properties:
                                      spelling_assessments:
                                        type: array
                                        items:
                                          type: object
                                          properties:
                                            assessment_text:
                                              type: string
                                              example: eg
                                            recommendation:
                                              type: string
                                              example: >-
                                                Replace 'eg' with 'e.g.,' to correct the
                                                abbreviation.
                                      grammar_assessments:
                                        type: array
                                        items:
                                          type: object
                                          properties:
                                            assessment_text:
                                              type: string
                                              example: >-
                                                online courses could provide the same
                                                quality of education similar to the one
                                                a student will experience in a
                                                classroom.But
                                            mistake_type:
                                              type: string
                                              example: proper_punctuation
                                            recommendation:
                                              type: string
                                              example: Add a space after the period.
                                  score:
                                    type: number
                                    example: 4
                                  reason:
                                    type: string
                                    example: >-
                                      The response thoroughly addresses the
                                      prompt by discussing both the potential
                                      benefits and shortcomings of online
                                      courses in comparison to traditional
                                      classroom-based learning. The ideas are
                                      clear, mostly relevant, and well-developed
                                      with specific examples. The structure is
                                      logical, with an introduction, body, and
                                      some form of conclusion. A variety of
                                      sentence structures is employed, though
                                      there are some minor grammatical issues.
                                      Vocabulary usage is adequate, but could be
                                      enhanced with more precise word choice.
                                      The response adheres to the task
                                      requirements.
                                  scope_of_improvement:
                                    type: string
                                    example: >-
                                      To enhance the response, the student could
                                      provide more depth in the evidence and
                                      examples offered, as well as improve the
                                      range of vocabulary used to make the
                                      argument more compelling. Additionally,
                                      refining transitions and cohesion can aid
                                      in a smoother flow of ideas.
                                  answer_holistic_evaluation:
                                    type: array
                                    items:
                                      type: object
                                      properties:
                                        holistic_criteria_id:
                                          type: string
                                          example: h1
                                        holistic_criteria_name:
                                          type: string
                                          example: TASK_FULFILLMENT
                                        feedback:
                                          type: array
                                          items:
                                            type: object
                                            properties:
                                              response_completeness:
                                                type: object
                                                properties:
                                                  score:
                                                    type: number
                                                    example: 5
                                                  explanation:
                                                    type: string
                                                    example: >-
                                                      The response fully addresses the prompt
                                                      by discussing both the potential
                                                      benefits and challenges of online
                                                      courses compared to traditional
                                                      classroom learning.
                                              clarity_and_relevance_of_ideas:
                                                type: object
                                                properties:
                                                  score:
                                                    type: number
                                                    example: 4
                                                  explanation:
                                                    type: string
                                                    example: >-
                                                      The ideas are mostly clear and relevant,
                                                      although there are some minor lapses in
                                                      clarity with the discourse on the pros
                                                      and cons.
                                              development_of_ideas:
                                                type: object
                                                properties:
                                                  score:
                                                    type: number
                                                    example: 4
                                                  explanation:
                                                    type: string
                                                    example: >-
                                                      Ideas are mostly developed, with some
                                                      lacking depth or supporting details,
                                                      such as the explanation on flexibility
                                                      and self-paced learning
                                              word_count_and_adherence_to_requirements:
                                                type: object
                                                properties:
                                                  score:
                                                    type: number
                                                    example: 4
                                                  explanation:
                                                    type: string
                                                    example: >-
                                                      The response meets the word count and
                                                      adheres perfectly to the task
                                                      instructions.
                                        holistic_criteria_score:
                                          type: number
                                          example: 4.5
                    status:
                      type: string
                      example: completed
                    error:
                      type: string
                      example: ''
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: Evaluation report not found
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````