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

>  This API allows authenticated users to retrieve all boards.

**How to Use:** 
 1. Call `GET /metadata/v1/board` to get the list of all boards and their unique `id` values. 
 2. Use the `id` of the required board in lesson plans or any other feature that needs a board reference.

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



## OpenAPI

````yaml GET /metadata/v1/board
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:
    get:
      summary: List Boards
      description: >-
        Retrieve all boards. Use this endpoint to get the list of boards and
        their IDs, which can be used in lesson plans or other features.
      responses:
        '200':
          description: A list of boards.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Board'
              example:
                - id: baf36573-d049-4636-9c4b-bc9cda6270fe
                  name: CBSE
        '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'
      security:
        - bearerAuth: []
components:
  schemas:
    Board:
      type: object
      properties:
        id:
          type: string
          description: Unique identifier for the board.
        name:
          type: string
          description: Name of the board.
    403Response:
      type: object
      properties:
        detail:
          type: string
          example: Token has expired
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````