Get Seating Chart

GET /classes/{classId}/seating-chart

Bearer auth

Retrieves the seating chart layout for a specific class.

Path parameters

classId string Required

The class ID

Responses

200 application/json

Seating chart retrieved successfully
Hide response attributes Show response attributes object
- success boolean
- code integer(int32)
- message string
- data object
  
  Seating chart layout object representing classroom arrangement
  
  Hide data attributes Show data attributes object
  
  rows integer
  
  Number of rows in the classroom layout
  
  columns integer
  
  Number of columns in the classroom layout
  
  seats array[object]
  
  Array of seats in the layout
  
  Seat object representing a single seat in the classroom
  
  Hide seats attributes Show seats attributes object
  
  id string
  
  Unique identifier for the seat
  
  studentId string | null
  
  ID of the assigned student, null if empty
  
  separatorInterval integer | null
  
  Interval for separators in the layout
404 application/json

Class or seating chart not found
Hide response attributes Show response attributes object
- success boolean
- code integer
- errorCode string
- message string
- timestamp string(date-time)
500 application/json

Internal Server Error
Hide response attributes Show response attributes object
- success boolean
- code integer
- errorCode string
- message string
- timestamp string(date-time)

GET /classes/{classId}/seating-chart

curl \
 --request GET 'http://localhost:8080/api/classes/{classId}/seating-chart' \
 --header "Authorization: Bearer $ACCESS_TOKEN"

Response examples (200)

{
  "success": true,
  "code": 200,
  "message": "string",
  "data": {
    "rows": 5,
    "columns": 6,
    "seats": [
      {
        "id": "seat_123456",
        "studentId": "std_123456"
      }
    ],
    "separatorInterval": 2
  }
}

Response examples (404)

{
  "success": false,
  "code": 42,
  "errorCode": "string",
  "message": "string",
  "timestamp": "2026-05-04T09:42:00Z"
}

Response examples (500)

{
  "success": false,
  "code": 42,
  "errorCode": "string",
  "message": "string",
  "timestamp": "2026-05-04T09:42:00Z"
}