API Reference — Documentation

GET /api/students List Students

Get a paginated list of students.

Authentication

Requires JWT token in Authorization header.

Permissions: students.view

Headers

{
    "Authorization": "Bearer <token>"
}

Parameters

{
    "page": {
        "type": "integer",
        "default": 1
    },
    "per_page": {
        "type": "integer",
        "default": 20
    },
    "search": {
        "type": "string"
    }
}

Example Response

{
    "success": true,
    "data": [
        {
            "id": 1,
            "name": "Jane Doe"
        }
    ],
    "pagination": {
        "total": 150,
        "page": 1
    }
}

GET /api/students/{id} Get Student

Get detailed information about a specific student.

Authentication

Requires JWT token in Authorization header.

Permissions: students.view

Headers

{
    "Authorization": "Bearer <token>"
}

Parameters

{
    "id": {
        "type": "integer",
        "required": true
    }
}

Example Response

{
    "success": true,
    "data": {
        "id": 1,
        "name": "Jane Doe",
        "class": "Grade 10A"
    }
}

POST /api/students Create Student

Create a new student record.

Authentication

Requires JWT token in Authorization header.

Permissions: students.create

Headers

{
    "Authorization": "Bearer <token>",
    "Content-Type": "application\/json"
}

Request Body

{
    "name": {
        "type": "string",
        "required": true
    },
    "admission_number": {
        "type": "string",
        "required": true
    },
    "class_id": {
        "type": "integer",
        "required": true
    }
}

Example Request

{
    "name": "Jane Doe",
    "admission_number": "STU001",
    "class_id": 5
}

Example Response

{
    "success": true,
    "data": {
        "id": 42
    }
}