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

>  This API allows authenticated users to retrieve all grades for a specific board. 

 **How to Use:** 
 1. Call `GET /metadata/v1/board/{board_id}/grades` with the required board's `id` to get the list of all grades for that board. 
 2. Use the `id` of the required grade in lesson plans or any other feature that needs a grade reference. 

 **Example Scenario:** A teacher wants to create or view a lesson plan for a specific grade within a board: - First, they call the boards API to list all boards and find the required board's `id`. - Then, they call this API to list all grades for that board and find the required grade's `id`. - Finally, they use that grade `id` in the lesson plan API or anywhere else in the system where a grade reference is needed. 



## OpenAPI

````yaml GET /metadata/v1/board/{board_id}/grades
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:
  /metadata/v1/board/{board_id}/grades:
    get:
      summary: List Grades for Board
      description: >-
        Retrieve all grades for a specific board. Use this endpoint to get the
        list of grades associated with a board, which can be used in lesson
        plans or other features. You must provide the board ID in the path
        parameter.
      parameters:
        - name: board_id
          in: path
          required: true
          schema:
            type: string
          description: Unique identifier of the board.
      responses:
        '200':
          description: A list of grades for the specified board.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Grade'
              example:
                - id: 657d1bf2-e5dd-46a9-9bf6-eebbe88fe958
                  name: Grade 12
        '401':
          description: Unauthorized access.
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: Unauthorized User
                  data:
                    type: object
                    example: {}
                  status:
                    type: string
                    example: ''
        '403':
          description: Authentication failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/403Response'
        '404':
          description: Board not found.
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: array
                    items:
                      type: object
                      properties:
                        error:
                          type: string
                          example: Board not found
        '422':
          description: Validation Error - Invalid UUID format.
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: array
                    items:
                      type: object
                      properties:
                        type:
                          type: string
                          example: uuid_parsing
                        loc:
                          type: array
                          items:
                            type: string
                          example:
                            - path
                            - board_id
                        msg:
                          type: string
                          example: >-
                            Input should be a valid UUID, invalid group length
                            in group 4: expected 12, found 11
                        input:
                          type: string
                          example: baf36573-d049-4636-9c4b-bc9cda6270f
                        ctx:
                          type: object
                          properties:
                            error:
                              type: string
                              example: >-
                                invalid group length in group 4: expected 12,
                                found 11
      security:
        - bearerAuth: []
components:
  schemas:
    Grade:
      type: object
      properties:
        id:
          type: string
          description: Unique identifier for the grade.
        name:
          type: string
          description: Name of the grade.
    403Response:
      type: object
      properties:
        detail:
          type: string
          example: Token has expired
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````