{"info":{"_postman_id":"fe4c3d55-5666-449c-acbf-ae4d8be85d0d","name":"Tech4dev-group-55","description":"<html><head></head><body><h1 id=\"tech4dev-group-55-api-documentation\">Tech4dev-group-55 API Documentation</h1>\n<p>Welcome to the <strong>Tech4dev-group-55</strong> API collection. This collection covers the backend API for a student performance analysis platform powered by an AI prediction model, along with user authentication endpoints. It is designed and maintained by the Tech4dev Group 55 team.</p>\n<hr>\n<h2 id=\"overview\">Overview</h2>\n<p>This API provides two core areas of functionality:</p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Module</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><strong>Authentication</strong></td>\n<td>User registration, login, and access management</td>\n</tr>\n<tr>\n<td><strong>AI Prediction Model</strong></td>\n<td>Analyses student results and recommends improvement strategies</td>\n</tr>\n</tbody>\n</table>\n</div><hr>\n<h2 id=\"getting-started\">Getting Started</h2>\n<h3 id=\"base-url\">Base URL</h3>\n<p>All requests use a base URL stored in the <code>{{baseUrl}}</code> collection variable. Set this variable to your environment's base URL before making requests.</p>\n<h3 id=\"authentication\">Authentication</h3>\n<p>Most endpoints require a valid Bearer token. After logging in via the <strong>Authentication</strong> endpoints, copy the returned token and set it as:</p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code>Authorization: Bearer {{token}}\n</code></pre><p>You can store the token in an environment variable (e.g., <code>{{token}}</code>) for reuse across requests.</p>\n<hr>\n<h2 id=\"folders\">Folders</h2>\n<h3 id=\"🔐-authentication\">🔐 Authentication</h3>\n<p>Handles all user identity operations including registration and login. These endpoints must be called first to obtain an access token required by protected routes.</p>\n<p><strong>Key Endpoints:</strong></p>\n<ul>\n<li><strong>Register (Step 1)</strong> — Initiates the user registration process</li>\n<li><strong>Register (Step 2)</strong> — Completes registration (supports both JSON and CSV bulk upload)</li>\n<li><strong>Verify Invite</strong> — Validates an invitation token sent to a user</li>\n<li><strong>Set Password</strong> — Allows a newly registered user to set their account password</li>\n<li><strong>Admin Login</strong> — Authenticates an admin user and returns a JWT access token</li>\n<li><strong>Get Team</strong> — Retrieves team/group information for authenticated users</li>\n</ul>\n<hr>\n<h3 id=\"🤖-ai-prediction-model\">🤖 AI Prediction Model</h3>\n<p>This module powers the core intelligence of the platform. It analyses student academic results and uses machine learning to recommend personalised improvement strategies.</p>\n<blockquote>\n<p><em>This is an AI prediction model that analyses student results and recommends ways in which they can improve.</em></p>\n</blockquote>\n<p><strong>Key Endpoints:</strong></p>\n<ul>\n<li><strong>CSV Upload</strong> — Bulk-upload student result data via a CSV file for batch prediction processing</li>\n<li><strong>Prediction Requests</strong> — Submit individual or grouped student data for AI-driven analysis and recommendations</li>\n</ul>\n<hr>\n<h2 id=\"common-patterns\">Common Patterns</h2>\n<h3 id=\"request-headers\">Request Headers</h3>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code>Content-Type: application/json\nAuthorization: Bearer {{token}}\n</code></pre><h3 id=\"csv-upload\">CSV Upload</h3>\n<p>For bulk operations, use <code>multipart/form-data</code> with a <code>file</code> field containing a valid <code>.csv</code> file.</p>\n<h3 id=\"error-responses\">Error Responses</h3>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Status Code</th>\n<th>Meaning</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>400</code></td>\n<td>Bad Request — Invalid input or missing required fields</td>\n</tr>\n<tr>\n<td><code>401</code></td>\n<td>Unauthorized — Missing or invalid authentication token</td>\n</tr>\n<tr>\n<td><code>403</code></td>\n<td>Forbidden — Insufficient permissions</td>\n</tr>\n<tr>\n<td><code>404</code></td>\n<td>Not Found — Resource does not exist</td>\n</tr>\n<tr>\n<td><code>500</code></td>\n<td>Internal Server Error — Unexpected server-side error</td>\n</tr>\n</tbody>\n</table>\n</div><hr>\n<h2 id=\"variables\">Variables</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Variable</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>{{baseUrl}}</code></td>\n<td>The base URL of the API server</td>\n</tr>\n<tr>\n<td><code>{{token}}</code></td>\n<td>JWT Bearer token obtained after login</td>\n</tr>\n</tbody>\n</table>\n</div><hr>\n<h2 id=\"additional-information\">Additional Information</h2>\n<ul>\n<li><strong>Team:</strong> Tech4dev Group 55</li>\n<li><strong>Platform:</strong> Postman API Platform</li>\n<li><strong>Last Updated:</strong> February 2026</li>\n</ul>\n<p>For questions or contributions, please reach out to the Tech4dev Group 55 team.</p>\n</body></html>","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[{"content":"Tech4dev-group-55 API Documentation","slug":"tech4dev-group-55-api-documentation"}],"owner":"45518060","collectionId":"fe4c3d55-5666-449c-acbf-ae4d8be85d0d","publishedId":"2sBXcGDz5P","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2026-02-24T19:47:35.000Z"},"item":[{"name":"AI-prediction-model","item":[{"name":"New Request","id":"ac10934c-bf98-44f4-98af-e5d36a5976e6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n  \"study_hours\": 19,\r\n  \"attendance\": 85,\r\n  \"resources\": 1,\r\n  \"extracurricular\": 1,\r\n  \"motivation\": 3,\r\n  \"internet\": 1,\r\n  \"gender\": 1,\r\n  \"age\": 22,\r\n  \"online_courses\": 8,\r\n  \"discussions\": 1,\r\n  \"assignment_completion\": 75,\r\n  \"edtech_usage_level\": 1,\r\n  \"stress_level\": 2,\r\n  \"learning_style\": 1\r\n}","options":{"raw":{"language":"json"}}},"url":"https://eduspline-ai-prediction-model-1.onrender.com/predict","urlObject":{"protocol":"https","path":["predict"],"host":["eduspline-ai-prediction-model-1","onrender","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"ac10934c-bf98-44f4-98af-e5d36a5976e6"},{"name":"New Request","id":"d69c93cb-f11c-4b10-998b-557cdf7e28d1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://eduspline-ai-prediction-model-1.onrender.com","urlObject":{"protocol":"https","host":["eduspline-ai-prediction-model-1","onrender","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"d69c93cb-f11c-4b10-998b-557cdf7e28d1"},{"name":"New Request","id":"e0ded27c-7ea3-49d2-9a80-5a3a8c25ed17","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://eduspline-ai-prediction-model-1.onrender.com/model-info","urlObject":{"protocol":"https","path":["model-info"],"host":["eduspline-ai-prediction-model-1","onrender","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"e0ded27c-7ea3-49d2-9a80-5a3a8c25ed17"},{"name":"csv upload","id":"c493bba2-4e24-433b-8942-f9c0db4945ca","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"file","type":"file","uuid":"1f79cd84-7773-4569-9f6e-04169af99ee0","src":"/C:/Users/okwuo/Downloads/test_students (1).csv"}]},"url":"https://eduspline-ai-prediction-model-1.onrender.com/predict/batch/json","urlObject":{"protocol":"https","path":["predict","batch","json"],"host":["eduspline-ai-prediction-model-1","onrender","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"c493bba2-4e24-433b-8942-f9c0db4945ca"}],"id":"9d487a5f-6aec-4dd4-b43b-4c9764d20453","description":"<p>This is Ai prediction model that analyse student result and recommend ways in which they can improve</p>\n","_postman_id":"9d487a5f-6aec-4dd4-b43b-4c9764d20453"},{"name":"Authentication","item":[{"name":"Admin signup","id":"b8cd9c40-1ce5-4027-9a84-2316df2b27c7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n  \"email\": \"adaobiokosa57@gmail.com\",\r\n  \"password\": \"Admin@1234\",\r\n  \"confirmPassword\": \"Admin@1234\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://eduspline-backend.onrender.com/api/auth/signup","description":"<p>Sign-up</p>\n","urlObject":{"protocol":"https","path":["api","auth","signup"],"host":["eduspline-backend","onrender","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"b8cd9c40-1ce5-4027-9a84-2316df2b27c7"},{"name":"verify-email","id":"b881e1be-75e7-47d4-b784-823a567eab6d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"raw","raw":"{\r\n  \"email\": \"adaobiokosa57@gmail.com\",\r\n  \"password\": \"Admin@1234\",\r\n  \"confirmPassword\": \"Admin@1234\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://eduspline-backend.onrender.com/api/auth/verify-email?token={token}","description":"<p>Sign-up</p>\n","urlObject":{"protocol":"https","path":["api","auth","verify-email"],"host":["eduspline-backend","onrender","com"],"query":[{"key":"token","value":"{token}"}],"variable":[]}},"response":[],"_postman_id":"b881e1be-75e7-47d4-b784-823a567eab6d"},{"name":"Admin-login","id":"7ec0dc5c-6aa2-4710-9c38-3ddd3a9cbd7d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n  \"email\": \"adaobiokosa57@gmail.com\",\r\n  \"password\": \"Admin@1234\"}","options":{"raw":{"language":"json"}}},"url":"https://eduspline-backend.onrender.com/api/auth/login","urlObject":{"protocol":"https","path":["api","auth","login"],"host":["eduspline-backend","onrender","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"7ec0dc5c-6aa2-4710-9c38-3ddd3a9cbd7d"},{"name":"Register-step1","id":"88445ecf-368c-4845-bc3f-f8f5e2314d69","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"<token>"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"\r\n{\r\n  \"name\": \"Tex Academy\",\r\n  \"type\": \"edtech\",\r\n  \"estimatedLearners\": \"100-500\",\r\n  \"country\": \"Nigeria\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://eduspline-backend.onrender.com/api/auth/institution","urlObject":{"protocol":"https","path":["api","auth","institution"],"host":["eduspline-backend","onrender","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"88445ecf-368c-4845-bc3f-f8f5e2314d69"},{"name":"register-step2","id":"70de0929-21cc-4bb5-8fc5-87f101b5c3fd","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"<token>"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n  \"name\": \"Adaobi lynda\",\r\n  \"email\": \"okwuosaadaobi6@gmail.com\",\r\n  \"role\": \"instructor\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://eduspline-backend.onrender.com/api/team/invite","urlObject":{"protocol":"https","path":["api","team","invite"],"host":["eduspline-backend","onrender","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"70de0929-21cc-4bb5-8fc5-87f101b5c3fd"},{"name":"verify-invite","id":"2dbd4fde-eae7-4be4-9c7c-4ca31fb0e6b5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"\r\n{\r\n  \"token\": \"PASTE_TOKEN_HERE\",\r\n  \"password\": \"NewPass@1234\",\r\n  \"confirmPassword\": \"NewPass@1234\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://eduspline-backend.onrender.com/api/team/accept-invite","urlObject":{"protocol":"https","path":["api","team","accept-invite"],"host":["eduspline-backend","onrender","com"],"query":[{"disabled":true,"key":"token","value":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJlbWFpbCI6Im9rd3Vvc2FhZGFvYmk2QGdtYWlsLmNvbSIsImluc3RpdHV0aW9uSWQiOiI2OTk4YzgyZWUxZmVkODcxN2YzMTI4ZWMiLCJyb2xlIjoiaW5zdHJ1Y3RvciIsImlhdCI6MTc3MTYyMDY3MywiZXhwIjoxNzcxNzkzNDczfQ.Ln79ES8iiZxPTW4Z5Gf1zLX7NQutD-EJeUasWNteiW0"}],"variable":[]}},"response":[],"_postman_id":"2dbd4fde-eae7-4be4-9c7c-4ca31fb0e6b5"},{"name":"set-password","id":"29701992-8c9c-48c4-a671-ed045ec3213d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n  \"email\": \"okwuosaadaobi6@gmail.com\",\r\n  \"password\": \"Instructor@1234\",\r\n  \"confirmPassword\": \"Instructor@1234\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://eduspline-backend.onrender.com/api/auth/set-password","urlObject":{"protocol":"https","path":["api","auth","set-password"],"host":["eduspline-backend","onrender","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"29701992-8c9c-48c4-a671-ed045ec3213d"},{"name":"get team","id":"c00ef0ba-db91-4023-a02c-30adb85511d6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"<token>"}]},"isInherited":false},"method":"GET","header":[],"url":"https://eduspline-backend.onrender.com/api/team","urlObject":{"protocol":"https","path":["api","team"],"host":["eduspline-backend","onrender","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"c00ef0ba-db91-4023-a02c-30adb85511d6"},{"name":"register-step2-csv","id":"b5b9fcec-6639-4c5f-92a6-4bc499de1ff9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"<token>"}]},"isInherited":false},"method":"POST","header":[{"key":"file","value":"","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"file","type":"file","uuid":"76d4f269-8e61-43b1-832d-edd8cab990b4","src":"/C:/Users/okwuo/Downloads/team.csv"}]},"url":"https://eduspline-backend.onrender.com/api/team/invite/csv","urlObject":{"protocol":"https","path":["api","team","invite","csv"],"host":["eduspline-backend","onrender","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"b5b9fcec-6639-4c5f-92a6-4bc499de1ff9"},{"name":"change-password","id":"0fad2f13-4924-46ce-b0ee-3b2e4fe7bb49","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\r\n  \"oldPassword\": \"Admin@1234\",\r\n  \"newPassword\": \"NewPass@5678\",\r\n  \"confirmNewPassword\": \"NewPass@5678\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://eduspline-backend.onrender.com/api/auth/change-password","urlObject":{"protocol":"https","path":["api","auth","change-password"],"host":["eduspline-backend","onrender","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"0fad2f13-4924-46ce-b0ee-3b2e4fe7bb49"},{"name":"get-logged-in-user","id":"fe8bc508-9f6b-4e95-9595-96302517d826","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"<token>"}]},"isInherited":false},"method":"GET","header":[],"url":"https://eduspline-backend.onrender.com/api/auth/me","urlObject":{"protocol":"https","path":["api","auth","me"],"host":["eduspline-backend","onrender","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"fe8bc508-9f6b-4e95-9595-96302517d826"},{"name":"GOOGLE-AUTH","id":"964d9442-af21-4cd6-83a4-71857599ee62","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://eduspline-backend.onrender.com/api/auth/google","urlObject":{"protocol":"https","path":["api","auth","google"],"host":["eduspline-backend","onrender","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"964d9442-af21-4cd6-83a4-71857599ee62"},{"name":"google Oauth callback","id":"b243d68b-7ae2-4eea-adac-89123d3a57e7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://eduspline-backend.onrender.com//api/auth/google/callback","urlObject":{"protocol":"https","path":["","api","auth","google","callback"],"host":["eduspline-backend","onrender","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"b243d68b-7ae2-4eea-adac-89123d3a57e7"}],"id":"e0910858-412b-4c95-8eb9-7b7a75714cee","_postman_id":"e0910858-412b-4c95-8eb9-7b7a75714cee","description":""},{"name":"Admin-dashboard","item":[{"name":"get dashboard-metrics","id":"29adb666-b098-4138-96f6-9c783594eb54","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"<token>"}]},"isInherited":false},"method":"GET","header":[],"url":"https://eduspline-backend.onrender.com/api/predictions/dashboard","urlObject":{"protocol":"https","path":["api","predictions","dashboard"],"host":["eduspline-backend","onrender","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"29adb666-b098-4138-96f6-9c783594eb54"},{"name":"prediction-insigt","id":"49dea1a0-8ebd-4a3a-98f0-48e7c0143ee9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"<token>"}]},"isInherited":false},"method":"GET","header":[],"url":"https://eduspline-backend.onrender.com/api/predictions/insights","urlObject":{"protocol":"https","path":["api","predictions","insights"],"host":["eduspline-backend","onrender","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"49dea1a0-8ebd-4a3a-98f0-48e7c0143ee9"},{"name":"get institution settings","id":"fb920470-cc05-4917-b9db-1f41215fc6cc","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"<token>"}]},"isInherited":false},"method":"GET","header":[],"url":"https://eduspline-backend.onrender.com/api/auth/settings","urlObject":{"protocol":"https","path":["api","auth","settings"],"host":["eduspline-backend","onrender","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"fb920470-cc05-4917-b9db-1f41215fc6cc"},{"name":"update-settings","id":"f6856802-76a9-4a76-9c17-acef094aa540","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PUT","header":[],"body":{"mode":"raw","raw":"\r\n { \"name\": \"Updated Academy\",\r\n  \"type\": \"edtech\",\r\n  \"estimatedLearners\": \"501-1000\",\r\n  \"country\": \"Nigeria\",\r\n  \"email\": \"newemail@institution.com\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://eduspline-backend.onrender.com/api/auth/settings","urlObject":{"protocol":"https","path":["api","auth","settings"],"host":["eduspline-backend","onrender","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"f6856802-76a9-4a76-9c17-acef094aa540"},{"name":"Admin-upload","id":"03783816-adfb-4c02-9fee-264175982d15","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"<token>"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"file","type":"file","uuid":"8078c165-f048-4f41-9d31-6d401c53d6ae","src":"/C:/Users/okwuo/Downloads/test_students (2).csv"}]},"url":"https://eduspline-backend.onrender.com/api/predictions/upload","urlObject":{"protocol":"https","path":["api","predictions","upload"],"host":["eduspline-backend","onrender","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"03783816-adfb-4c02-9fee-264175982d15"}],"id":"5e54c130-7181-4ccf-912f-513694192640","_postman_id":"5e54c130-7181-4ccf-912f-513694192640","description":""},{"name":"Student-dashboard","item":[{"name":"get-student-prediction","id":"53ff49f7-3ea6-4941-89cd-d95705f0b816","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://eduspline-backend.onrender.com/api/predictions/student","urlObject":{"protocol":"https","path":["api","predictions","student"],"host":["eduspline-backend","onrender","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"53ff49f7-3ea6-4941-89cd-d95705f0b816"}],"id":"c72ee230-6eb9-42c6-98b0-6922c9016619","_postman_id":"c72ee230-6eb9-42c6-98b0-6922c9016619","description":""}]}