> ## 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/ielts/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/ielts/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/ielts/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: object
                properties:
                  evaluation_id:
                    type: string
                    example: '123456789'
                  client_id:
                    type: string
                    example: c0001
                  institution_id:
                    type: string
                    example: 67890XYZ
                    description: >-
                      Identifier of the institution to which the student belongs
                      (optional).
                  teacher_id:
                    type: string
                    example: 98765LMN
                    description: >-
                      Identifier of the teacher responsible for the evaluation
                      (optional).
                  parent_id:
                    type: string
                    example: 54321PQR
                    description: >-
                      Identifier of the parent associated with the student
                      (optional).
                  evaluation_data:
                    type: object
                    properties:
                      student_id:
                        type: string
                        example: 11223STU
                      test_type:
                        type: string
                        example: AC
                        description: Type of IELTS exam the student is giving.
                      student_name:
                        type: string
                        example: John Doe
                      image_urls:
                        type: array
                        items:
                          type: string
                          format: uri
                        example:
                          - http://example.com/image1.jpg
                          - http://example.com/image2.jpg
                        description: >-
                          List of URLs pointing to the images submitted
                          (optional).
                      evaluation_text:
                        type: array
                        items:
                          type: object
                          properties:
                            question_number:
                              type: string
                              example: '1'
                            question_id:
                              type: string
                              example: q1
                            image_url:
                              type: string
                              format: uri
                              example: http://example.com/image1_processed.jpg
                              description: >-
                                Processed URL of the image related to the
                                question (if applicable).
                            section:
                              type: string
                              example: writing
                            question_type:
                              type: string
                              example: ilt001
                            question_text:
                              type: string
                              example: |+
                                You recently stayed for three nights at the
                                Mountainview Hotel. The hotel manager, David
                                Hodge, has written you an email asking for your
                                feedback on your stay.
                                You liked:
                                • Location close to hiking trails
                                • Restaurant, especially vegan options
                                One problem:
                                • the heater in your room made a loud noise
                                at night
                                Write a response email. Tell the manager:
                                • What you liked
                                • What was a problem
                                • If you would return to the hotel for another
                                Stay

                            question_media:
                              type: string
                              format: uri
                              example: http://example.com/audio1.mp3
                              description: >-
                                URL of multimedia related to the question
                                (optional).
                            answer_text:
                              type: string
                              example: >
                                Hello David,

                                I love staying at your Hotel specially for the
                                location near the hiking

                                trails and the restaurant. I usually don't like
                                vegan food but yours

                                was outstanding. As I said to your frontdesk
                                staff the only problem

                                that I had was the heater that made an awfull
                                amount of noise

                                during the night. I understand that there were
                                no other rooms

                                available, but that doesn't really make the
                                noise less loud.

                                Eventhoug I kinda clinged to the noise thing on
                                this email l'd choose

                                your hotel for an eventual return trip, l'd just
                                ask for a room with a

                                quiet heater if that's the case.
                            answer_media:
                              type: string
                              format: uri
                              example: http://example.com/audio2.mp3
                              description: >-
                                URL of multimedia related to the answer
                                (optional).
                            score:
                              type: integer
                              example: 24
                              description: Score assigned to the answer.
                            reason:
                              type: string
                              example: >-
                                Good understanding of the lecture content but
                                needs more detail.
                            scope_of_improvement:
                              type: string
                              example: Provide more specific examples and details.
                              description: Feedback on areas of improvement.
                            answer_objective_evaluation:
                              type: array
                              items:
                                type: object
                                properties:
                                  objective_error_id:
                                    type: string
                                    example: e1
                                  objective_error_name:
                                    type: string
                                    example: Grammar
                                  objective_error_name_feedback:
                                    type: string
                                    example: Minor grammatical mistakes.
                              description: Objective evaluation errors and feedback.
                            answer_holistic_evaluation:
                              type: array
                              items:
                                type: object
                                properties:
                                  holistic_criteria_id:
                                    type: string
                                    example: h1
                                  holistic_criteria_name:
                                    type: string
                                    example: Content
                                  holistic_criteria_score:
                                    type: integer
                                    example: 4
                                  holistic_criteria_name_feedback:
                                    type: string
                                    example: Well-covered but could be more thorough.
                              description: >-
                                Holistic evaluation criteria, score, and
                                feedback.
                            answer_custom_evaluation:
                              type: array
                              items:
                                type: object
                                properties:
                                  custom_criteria_id:
                                    type: string
                                    example: h1
                                  custom_criteria_name:
                                    type: string
                                    example: Content
                                  custom_criteria_score:
                                    type: integer
                                    example: 4
                                  custom_criteria_name_feedback:
                                    type: string
                                    example: Well-covered but could be more thorough.
                              description: Custom evaluation criteria, score, and feedback.
                          required:
                            - question_number
                            - question_id
                            - section
                            - question_type
                            - question
                            - answer
                        description: List of evaluated questions and answers.
                    required:
                      - student_id
                      - test_type
                      - student_name
        '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

````