{"info":{"_postman_id":"b35cc71d-7428-4284-9baa-97bcd8985721","name":"student-api","description":"

StartFragment

Student Management REST API

Project Structure

student-api/├── package.json├── server.js├── data/students.js└── routes/studentRoutes.js\n\n

package.json

{    \"name\": \"student-api\",    \"version\": \"1.0.0\",    \"main\": \"server.js\",    \"scripts\": {        \"start\": \"node server.js\",        \"dev\": \"nodemon server.js\"    },    \"dependencies\": {        \"express\": \"^4.18.2\"    },    \"devDependencies\": {        \"nodemon\": \"^3.1.0\"    }}\n\n

server.js

const express = require(\"express\");const app = express();app.use(express.json());app.use(\"/students\", require(\"./routes/    studentRoutes\"));app.get(\"/\", (req, res) => {  res.json({ message: \"Student Management     API is running\" });});app.use((req, res) => res.status(404).json({     error: \"Route not found\" }));app.listen(3002, () => console.log(\"Server     running on http://localhost:3002\"));\n\n

data/students.js

module.exports = [  { id: 1,  name: \"Aarav Sharma\",  age: 22,     branch: \"CSE\",          cgpa: 9.3 },  { id: 2,  name: \"Ishita Verma\",  age: 21,     branch: \"IT\",           cgpa: 8.7 },  { id: 3,  name: \"Rohan Mehta\",   age: 20,     branch: \"ECE\",          cgpa: 7.5 },  { id: 4,  name: \"Meera Iyer\",    age: 22,     branch: \"CSE\",          cgpa: 9.1 },  { id: 5,  name: \"Arjun Patel\",   age: 21,     branch: \"AI\",           cgpa: 8.2 },  { id: 6,  name: \"Ananya Reddy\",  age: 21,     branch: \"CSE\",          cgpa: 8.7 },  { id: 7,  name: \"Vikram Singh\",  age: 20,     branch: \"Data Science\",  cgpa: 7.8 },  { id: 8,  name: \"Priya Nair\",    age: 22,     branch: \"IT\",           cgpa: 8.9 },  { id: 9,  name: \"Karthik Rao\",   age: 21,     branch: \"ECE\",          cgpa: 7.2 },  { id: 10, name: \"Neha Gupta\",    age: 21,     branch: \"CSE\",          cgpa: 7.9 },];\n\n

routes/studentRoutes.js

const router = require(\"express\").Router();const students = require(\"../data/students\");// GET /students — All studentsrouter.get(\"/\", (req, res) => {  if (!students.length) return res.status    (404).json({ error: \"No students     found\" });  res.json(students);});// GET /students/topper — Highest CGPA     studentrouter.get(\"/topper\", (req, res) => {  if (!students.length) return res.status    (404).json({ error: \"No students     found\" });  res.json(students.reduce((top, s) => (s.    cgpa > top.cgpa ? s : top), students    [0]));});// GET /students/average-cgpa — Average CGPArouter.get(\"/average-cgpa\", (req, res) => {  if (!students.length) return res.status    (404).json({ error: \"No students     found\" });  const avg = parseFloat((students.reduce    ((sum, s) => sum + s.cgpa, 0) / students.    length).toFixed(2));  res.json({ averageCGPA: avg });});// GET /students/count — Total student countrouter.get(\"/count\", (req, res) => {  res.json({ totalStudents: students.    length });});// GET /students/branch/:branchName — Filter     by branchrouter.get(\"/branch/:branchName\", (req, res)     => {  const filtered = students.filter(    (s) => s.branch.toLowerCase() === req.        params.branchName.toLowerCase()  );  if (!filtered.length) return res.status    (404).json({ error: `No students found     in branch '${req.params.branchName}'` });  res.json(filtered);});// GET /students/:id — Student by IDrouter.get(\"/:id\", (req, res) => {  if (isNaN(req.params.id)) return res.status    (400).json({ error: \"ID must be a     number\" });  const student = students.find((s) => s.id     === parseInt(req.params.id));  if (!student) return res.status(404).json    ({ error: \"Student not found\" });  res.json(student);});module.exports = router;\n\n

Quick Start

npm install && npm start\n\n

StartFragment

API Endpoints

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Method	Endpoint	Response
GET	`/students`	All students array
GET	`/students/topper`	Highest CGPA student
GET	`/students/average-cgpa`	`{ \"averageCGPA\": 8.33 }`
GET	`/students/count`	`{ \"totalStudents\": 10 }`
GET	`/students/:id`	Single student object
GET	`/students/branch/:name`	Filtered students array

EndFragment

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"50839281","collectionId":"b35cc71d-7428-4284-9baa-97bcd8985721","publishedId":"2sBXcGCz69","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2026-02-24T06:51:27.000Z"},"item":[{"name":"all-student-details","id":"88511d50-d60d-407a-aeb4-9bac137a73f6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://localhost:3002/students","description":"

Get all students

Returns the full list of students from the Students API.

Endpoint

Base URL: http://localhost:3002
\n
Method: GET
\n
Path: /students
\n
Full URL: http://localhost:3002/students
\n

What it does

Fetches all student records and returns them as a JSON array.

Expected response

Status: 200 OK
\n
Content-Type: application/json
\n

Response schema (JSON)

[\n  {\n    \"id\": 1,\n    \"name\": \"string\",\n    \"branch\": \"string\",\n    \"semester\": 1,\n    \"cgpa\": 0\n  }\n]\n\n

id (number): Unique student identifier
\n
name (string): Student full name
\n
branch (string): Department / branch (e.g., CSE, IT, ECE, AI, Data Science)
\n
semester (number): Current semester
\n
cgpa (number): CGPA (typically 0.0–10.0)
\n

Sample response

[\n  {\"id\":1,\"name\":\"Aarav Sharma\",\"branch\":\"CSE\",\"semester\":8,\"cgpa\":9.3},\n  {\"id\":2,\"name\":\"Ishita Verma\",\"branch\":\"IT\",\"semester\":7,\"cgpa\":8.9},\n  {\"id\":3,\"name\":\"Rohan Kulkarni\",\"branch\":\"ECE\",\"semester\":6,\"cgpa\":8.4},\n  {\"id\":4,\"name\":\"Meera Iyer\",\"branch\":\"CSE\",\"semester\":8,\"cgpa\":9.1},\n  {\"id\":5,\"name\":\"Kunal Deshmukh\",\"branch\":\"IT\",\"semester\":5,\"cgpa\":7.8},\n  {\"id\":6,\"name\":\"Ananya Reddy\",\"branch\":\"CSE\",\"semester\":6,\"cgpa\":8.7},\n  {\"id\":7,\"name\":\"Vikram Patil\",\"branch\":\"ECE\",\"semester\":7,\"cgpa\":8.2},\n  {\"id\":8,\"name\":\"Priyanka Nair\",\"branch\":\"AI\",\"semester\":4,\"cgpa\":8.8},\n  {\"id\":9,\"name\":\"Harsh Mehta\",\"branch\":\"Data Science\",\"semester\":5,\"cgpa\":8},\n  {\"id\":10,\"name\":\"Neha Gupta\",\"branch\":\"CSE\",\"semester\":6,\"cgpa\":7.9}\n]\n\n

Common use cases

Populate a UI table/list of all students
\n
Initial data load for dashboards/analytics
\n
Validate that the service/database contains expected seed data
\n
Smoke test for API availability
\n

Possible errors

\n
Exact error payloads depend on your backend implementation.
\n

500 Internal Server Error: Server-side failure while reading students
\n
503 Service Unavailable: Server not running / dependency unavailable
\n
404 Not Found: Route not registered (or incorrect base URL/port)
\n

Notes

If the server is running on a different host/port, update the base URL accordingly.

\n","urlObject":{"protocol":"http","port":"3002","path":["students"],"host":["localhost"],"query":[],"variable":[]}},"response":[{"id":"e6ec18e8-674a-4dea-af1d-a5cef2198bd1","name":"all-student-details","originalRequest":{"method":"GET","header":[],"url":"http://localhost:3002/students"},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":"X-Powered-By","value":"Express"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"706"},{"key":"ETag","value":"W/\"2c2-eg8a8aTavyPAgNHP/P5m4llaFTk\""},{"key":"Date","value":"Tue, 24 Feb 2026 06:19:25 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": 1,\n \"name\": \"Aarav Sharma\",\n \"branch\": \"CSE\",\n \"semester\": 8,\n \"cgpa\": 9.3\n },\n {\n \"id\": 2,\n \"name\": \"Ishita Verma\",\n \"branch\": \"IT\",\n \"semester\": 7,\n \"cgpa\": 8.9\n },\n {\n \"id\": 3,\n \"name\": \"Rohan Kulkarni\",\n \"branch\": \"ECE\",\n \"semester\": 6,\n \"cgpa\": 8.4\n },\n {\n \"id\": 4,\n \"name\": \"Meera Iyer\",\n \"branch\": \"CSE\",\n \"semester\": 8,\n \"cgpa\": 9.1\n },\n {\n \"id\": 5,\n \"name\": \"Kunal Deshmukh\",\n \"branch\": \"IT\",\n \"semester\": 5,\n \"cgpa\": 7.8\n },\n {\n \"id\": 6,\n \"name\": \"Ananya Reddy\",\n \"branch\": \"CSE\",\n \"semester\": 6,\n \"cgpa\": 8.7\n },\n {\n \"id\": 7,\n \"name\": \"Vikram Patil\",\n \"branch\": \"ECE\",\n \"semester\": 7,\n \"cgpa\": 8.2\n },\n {\n \"id\": 8,\n \"name\": \"Priyanka Nair\",\n \"branch\": \"AI\",\n \"semester\": 4,\n \"cgpa\": 8.8\n },\n {\n \"id\": 9,\n \"name\": \"Harsh Mehta\",\n \"branch\": \"Data Science\",\n \"semester\": 5,\n \"cgpa\": 8\n },\n {\n \"id\": 10,\n \"name\": \"Neha Gupta\",\n \"branch\": \"CSE\",\n \"semester\": 6,\n \"cgpa\": 7.9\n }\n]"}],"_postman_id":"88511d50-d60d-407a-aeb4-9bac137a73f6"},{"name":"topper-student-only","id":"6fdf0299-4524-4b10-a68c-24273710552f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://localhost:3002/students/topper","description":"

Purpose

Fetch the top-performing student (the “topper”) from the Students API.

Endpoint

Method: GET
URL: http://localhost:3002/students/topper

\n
Base URL note: This request targets a local server (localhost). Make sure your API is running on http://localhost:3002 before sending the request.
\n

Response (200 OK)

Example response body (from the last successful run):

{\n  \"id\": 1,\n  \"name\": \"Aarav Sharma\",\n  \"branch\": \"CSE\",\n  \"semester\": 8,\n  \"cgpa\": 9.3\n}\n

Basic test notes

Recommended checks for this endpoint:

Assert status code is 200.
Assert response is JSON.
Assert required fields exist: id, name, branch, semester, cgpa.
Assert cgpa is a number and is present (optionally validate it’s within an expected range, e.g., 0–10).

\n","urlObject":{"protocol":"http","port":"3002","path":["students","topper"],"host":["localhost"],"query":[],"variable":[]}},"response":[{"id":"42691190-1f1f-4ed7-80bd-4778395f3230","name":"topper-student-only","originalRequest":{"method":"GET","header":[],"url":"http://localhost:3002/students/topper"},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":"X-Powered-By","value":"Express"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"69"},{"key":"ETag","value":"W/\"45-Zt+hMq9DFzGEG2U2YFMym5i2hhM\""},{"key":"Date","value":"Tue, 24 Feb 2026 06:19:45 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"id\": 1,\n \"name\": \"Aarav Sharma\",\n \"branch\": \"CSE\",\n \"semester\": 8,\n \"cgpa\": 9.3\n}"}],"_postman_id":"6fdf0299-4524-4b10-a68c-24273710552f"},{"name":"average-cgpa-of-students","id":"18e35db9-182c-4703-955b-928ca008ac95","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"description":"

Get Average CGPA

Returns the average CGPA across all students.

Endpoint

Method: GET
\n
URL: http://localhost:3002/students/average
\n

Response

Success (200)

Returns a JSON object containing the computed average CGPA.

Schema

{\n  \"averageCGPA\": number\n}\n\n

Example

{\n  \"averageCGPA\": 8.51\n}\n\n

Possible error responses

\n
Exact error payloads depend on your server implementation.
\n

500 Internal Server Error – Server-side error while calculating the average (e.g., database/query failure).
\n
404 Not Found – If the route is not registered on the server.
\n
503 Service Unavailable / Connection error – If the server is not running or not reachable.
\n

Notes

Ensure your backend server is running and reachable at http://localhost:3002.
\n
This endpoint does not require a request body.
\n

\n","urlObject":{"query":[],"variable":[]},"url":""},"response":[{"id":"9f033e5f-639c-42eb-b98d-2346f3d67354","name":"average-cgpa-of-students","originalRequest":{"method":"GET","header":[],"url":"http://localhost:3002/students/average"},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":"X-Powered-By","value":"Express"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"20"},{"key":"ETag","value":"W/\"14-eXAdQlJ0QC/O0FoKBN226pkONG0\""},{"key":"Date","value":"Tue, 24 Feb 2026 06:19:54 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"averageCGPA\": 8.51\n}"}],"_postman_id":"18e35db9-182c-4703-955b-928ca008ac95"},{"name":"total-students","id":"6c7a802e-bd45-4d1d-81da-0c758d3ea69b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://localhost:3002/students/count","description":"

Overview

Returns the total number of students available in the system.

Request

Method: GET
URL: http://localhost:3002/students/count

Successful Response

`200 OK`

Returns a JSON object containing the total student count.

Schema

{\n  \"totalstudents\": number\n}\n

Example

{\n  \"totalstudents\": 10\n}\n

Notes / Common issues

Ensure the API server is running and reachable at localhost:3002.
If the server is not running or the port is incorrect, you may see connection errors (for example ECONNREFUSED) or a 404 Not Found depending on your setup.
If your server is hosted elsewhere, update the base URL accordingly (e.g., by using an environment variable).

\n","urlObject":{"protocol":"http","port":"3002","path":["students","count"],"host":["localhost"],"query":[],"variable":[]}},"response":[{"id":"1be21962-eb02-40b0-b4d5-155acc1ff509","name":"total-students","originalRequest":{"method":"GET","header":[],"url":"http://localhost:3002/students/count"},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":"X-Powered-By","value":"Express"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"20"},{"key":"ETag","value":"W/\"14-3HG0j8M+thu3az/qW7y8bSEON0s\""},{"key":"Date","value":"Tue, 24 Feb 2026 06:20:02 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"totalstudents\": 10\n}"}],"_postman_id":"6c7a802e-bd45-4d1d-81da-0c758d3ea69b"},{"name":"get-student-details-by-id","id":"620b823b-27d2-46ce-bcee-fa342a049d43","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://localhost:3002/students/1","description":"

Purpose

Retrieve a single student record by ID.

Endpoint

GET http://localhost:3002/students/:id

Path parameters

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Param	Type	Required	Description
`id`	integer	Yes	The student ID to fetch.

Success response (200 OK)

Example response body

{\"id\":1,\"name\":\"Aarav Sharma\",\"branch\":\"CSE\",\"semester\":8,\"cgpa\":9.3}\n

Possible errors

400 Bad Request — Invalid id (e.g., non-numeric or out of allowed range).
404 Not Found — No student exists for the given id.
500 Internal Server Error — Unexpected server error.

\n","urlObject":{"protocol":"http","port":"3002","path":["students","1"],"host":["localhost"],"query":[],"variable":[]}},"response":[{"id":"40bf667f-6a7c-4201-b819-ef70b3f885fa","name":"get-student-details-by-id","originalRequest":{"method":"GET","header":[],"url":"http://localhost:3002/students/1"},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":"X-Powered-By","value":"Express"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"69"},{"key":"ETag","value":"W/\"45-Zt+hMq9DFzGEG2U2YFMym5i2hhM\""},{"key":"Date","value":"Tue, 24 Feb 2026 06:20:11 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"id\": 1,\n \"name\": \"Aarav Sharma\",\n \"branch\": \"CSE\",\n \"semester\": 8,\n \"cgpa\": 9.3\n}"}],"_postman_id":"620b823b-27d2-46ce-bcee-fa342a049d43"},{"name":"get-student-by-branch-name","id":"2e4dc80f-2640-4f55-841a-955605c7510d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://localhost:3002/students/branch/cse","description":"

Purpose

Fetch all students filtered by branch (CSE).

Endpoint

Method: GET
URL: http://localhost:3002/students/branch/cse
Path: /students/branch/cse

Sample 200 Response

[\n  {\"id\": 1, \"name\": \"Aarav Sharma\", \"branch\": \"CSE\", \"semester\": 8, \"cgpa\": 9.3},\n  {\"id\": 4, \"name\": \"Meera Iyer\", \"branch\": \"CSE\", \"semester\": 8, \"cgpa\": 9.1},\n  {\"id\": 6, \"name\": \"Ananya Reddy\", \"branch\": \"CSE\", \"semester\": 6, \"cgpa\": 8.7},\n  {\"id\": 10, \"name\": \"Neha Gupta\", \"branch\": \"CSE\", \"semester\": 6, \"cgpa\": 7.9}\n]\n

Notes (Filtering by branch)

This request returns only students in the CSE branch.
The branch filter is encoded in the path segment cse (i.e., /students/branch/{branch}).
To filter for a different branch, replace cse with the desired branch value (case sensitivity depends on the backend implementation).

\n","urlObject":{"protocol":"http","port":"3002","path":["students","branch","cse"],"host":["localhost"],"query":[],"variable":[]}},"response":[{"id":"13b953e2-e9eb-4394-ac5b-4dda60dec4a6","name":"get-student-by-branch-name","originalRequest":{"method":"GET","header":[],"url":"http://localhost:3002/students/branch/cse"},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":"X-Powered-By","value":"Express"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"278"},{"key":"ETag","value":"W/\"116-7pw088gxBxBRgBpYjICy+5DVdWA\""},{"key":"Date","value":"Tue, 24 Feb 2026 06:20:21 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": 1,\n \"name\": \"Aarav Sharma\",\n \"branch\": \"CSE\",\n \"semester\": 8,\n \"cgpa\": 9.3\n },\n {\n \"id\": 4,\n \"name\": \"Meera Iyer\",\n \"branch\": \"CSE\",\n \"semester\": 8,\n \"cgpa\": 9.1\n },\n {\n \"id\": 6,\n \"name\": \"Ananya Reddy\",\n \"branch\": \"CSE\",\n \"semester\": 6,\n \"cgpa\": 8.7\n },\n {\n \"id\": 10,\n \"name\": \"Neha Gupta\",\n \"branch\": \"CSE\",\n \"semester\": 6,\n \"cgpa\": 7.9\n }\n]"}],"_postman_id":"2e4dc80f-2640-4f55-841a-955605c7510d"}]}