GearGuard API is a role-based equipment maintenance management system designed to track industrial equipment, manage maintenance requests, organize teams, and generate analytical reports. The API supports secure authentication, equipment lifecycle management, maintenance workflows, team coordination, and dashboard insights using JWT authentication and role-based access control.
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"39216531","collectionId":"05899cbb-6d66-417a-b87f-4fdd9fe2ca81","publishedId":"2sBXVeGCzQ","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2026-01-08T18:06:52.000Z"},"item":[{"name":"Authentication","item":[{"name":"signup","id":"6df006bf-7e18-4570-8475-c90eb636ec7e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"name\": \"Ahmed Khan\",\r\n \"email\": \"ahmed@gearguard.com\",\r\n \"password\": \"SecurePass123!\",\r\n \"role\": \"technician\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://odooxadani.onrender.com/api/auth/register","description":"Registers a new user in the GearGuard system. This endpoint creates a user account with a specified role and returns a JWT token upon successful registration. No authentication token is required.
\n","urlObject":{"protocol":"https","path":["api","auth","register"],"host":["odooxadani","onrender","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"6df006bf-7e18-4570-8475-c90eb636ec7e"},{"name":"login","id":"049c045a-f7e4-4122-b52d-1521ab22c8ae","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"email\": \"ahmed@gearguard.com\",\r\n \"password\": \"SecurePass123!\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://odooxadani.onrender.com/api/auth/login","description":"Authenticates an existing user using email and password. On successful login, a JWT token is generated and returned for accessing protected APIs.
\n","urlObject":{"protocol":"https","path":["api","auth","login"],"host":["odooxadani","onrender","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"049c045a-f7e4-4122-b52d-1521ab22c8ae"},{"name":"me","id":"b48812a9-869d-44e8-a4ea-b65f02db450b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Retrieves the profile details of the currently authenticated user, including role, team assignment, and account status. Requires a valid JWT token.
\n","urlObject":{"protocol":"https","path":["api","auth","me"],"host":["odooxadani","onrender","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"b48812a9-869d-44e8-a4ea-b65f02db450b"},{"name":"manager-register","id":"41e09a6b-40a0-4b70-beb5-2c9ac6f4409a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"name\": \"manager\",\r\n \"email\": \"manager@gearguard.com\",\r\n \"password\": \"SecurePass123!\",\r\n \"role\": \"manager\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://odooxadani.onrender.com/api/auth/register","description":"Registers a new user in the GearGuard system. This endpoint creates a user account with a specified role and returns a JWT token upon successful registration. No authentication token is required.
\n","urlObject":{"protocol":"https","path":["api","auth","register"],"host":["odooxadani","onrender","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"41e09a6b-40a0-4b70-beb5-2c9ac6f4409a"},{"name":"manager-login","id":"9d1cfe21-9b5c-4605-b327-d314757b1b93","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"email\": \"manager@gearguard.com\",\r\n \"password\": \"SecurePass123!\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://odooxadani.onrender.com/api/auth/login","description":"Authenticates an existing user using email and password. On successful login, a JWT token is generated and returned for accessing protected APIs.
\n","urlObject":{"protocol":"https","path":["api","auth","login"],"host":["odooxadani","onrender","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"9d1cfe21-9b5c-4605-b327-d314757b1b93"}],"id":"d63b8d04-70d7-47e2-8c67-2a4b6a459a54","description":"This folder contains all authentication-related endpoints including user registration, login, and profile retrieval. These APIs handle secure user authentication using JWT tokens and support role-based access such as Admin, Manager, Technician, and User.
\n","_postman_id":"d63b8d04-70d7-47e2-8c67-2a4b6a459a54"},{"name":"equipment","item":[{"name":"equiment","id":"8e816056-e9ea-4325-9384-a23d4972e728","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Creates a new equipment record in the system with details such as serial number, department, location, and assigned maintenance team. Accessible only to Admin and Manager roles.
\n","urlObject":{"protocol":"https","path":["api","equipment"],"host":["odooxadani","onrender","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"8e816056-e9ea-4325-9384-a23d4972e728"},{"name":"equipment","id":"866759f2-5dd6-4213-8bdf-c8a8c836cc04","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Fetches a list of all registered equipment along with their assigned maintenance teams and technicians. Useful for inventory tracking and overview.
\n","urlObject":{"protocol":"https","path":["api","equipment"],"host":["odooxadani","onrender","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"866759f2-5dd6-4213-8bdf-c8a8c836cc04"},{"name":"single equipment","id":"7db597e9-8c9d-46ea-9dd0-3a10bfae46a2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Retrieves complete details of a specific equipment using its unique ID, including warranty information, assigned technician, and maintenance team.
\n","urlObject":{"protocol":"https","path":["api","equipment","694fbd33e42d3e817d2627d9"],"host":["odooxadani","onrender","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"7db597e9-8c9d-46ea-9dd0-3a10bfae46a2"},{"name":"update","id":"76f479c5-8110-436a-8e5a-0e342fa6c774","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Updates one or more fields of an existing equipment such as location, assigned employee, or default technician. Only Admin and Manager roles are allowed.
\n","urlObject":{"protocol":"https","path":["api","equipment","694fbd33e42d3e817d2627d9"],"host":["odooxadani","onrender","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"76f479c5-8110-436a-8e5a-0e342fa6c774"}],"id":"ee2bcf82-45d0-4195-ae31-0663a5ab62c9","description":"This folder manages all equipment-related operations including creating, updating, retrieving, and scrapping equipment. It allows administrators and managers to track equipment details, assign maintenance teams and technicians, and view equipment maintenance history.
\n","_postman_id":"ee2bcf82-45d0-4195-ae31-0663a5ab62c9"},{"name":"maintanance","item":[{"name":"maintanance","id":"532c5e97-f7ba-43cc-99bb-6a453459b5bd","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Returns the complete maintenance history of a specific equipment, including past repair tasks, assigned technicians, status, and duration.
\n","urlObject":{"protocol":"https","path":["api","equipment","694fbd33e42d3e817d2627d9","maintenance"],"host":["odooxadani","onrender","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"532c5e97-f7ba-43cc-99bb-6a453459b5bd"},{"name":"complete","id":"89506235-25fd-4f83-9e95-fef0c53602b7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Marks an equipment as scrapped, indicating it is no longer usable or active in the system. This action can only be performed by a Manager.
\n","urlObject":{"protocol":"https","path":["api","maintenance","694fc8997114b3b19eb9f005","complete"],"host":["odooxadani","onrender","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"89506235-25fd-4f83-9e95-fef0c53602b7"},{"name":"create maintainance","id":"8b2f4c5c-aab7-4085-8f64-c691a18af0fd","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Creates a new maintenance request for an equipment. Requests can be corrective or preventive and are automatically assigned to the equipment’s maintenance team.
\n","urlObject":{"protocol":"https","path":["api","maintenance"],"host":["odooxadani","onrender","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"8b2f4c5c-aab7-4085-8f64-c691a18af0fd"},{"name":"get maintainance","id":"a14833c6-2cb3-4b7f-942b-9adaef011637","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Fetches all maintenance requests with optional filters such as status, technician, team, and request type. Useful for dashboards and task tracking.
\n","urlObject":{"protocol":"https","path":["api","maintenance"],"host":["odooxadani","onrender","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"a14833c6-2cb3-4b7f-942b-9adaef011637"},{"name":"calendar","id":"ee76135c-d8b4-4ec5-8185-870881d3d4f9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Returns preventive maintenance requests in a calendar-friendly format to support scheduling and planning of upcoming maintenance tasks.
\n","urlObject":{"protocol":"https","path":["api","maintenance","calendar"],"host":["odooxadani","onrender","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"ee76135c-d8b4-4ec5-8185-870881d3d4f9"},{"name":"assign","id":"7cf9436b-0634-4f96-b145-404965dcf476","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Assigns a technician to a maintenance request. The technician must belong to the same maintenance team assigned to the equipment.
\n","urlObject":{"protocol":"https","path":["api","maintenance","694fc8997114b3b19eb9f005","assign"],"host":["odooxadani","onrender","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"7cf9436b-0634-4f96-b145-404965dcf476"},{"name":"status","id":"b48fd3b2-3abb-4609-900b-f160cff7ae00","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Updates the status of a maintenance request following a Kanban workflow: New → In Progress → Repaired.
\n","urlObject":{"protocol":"https","path":["api","maintenance","694fc8997114b3b19eb9f005","status"],"host":["odooxadani","onrender","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"b48fd3b2-3abb-4609-900b-f160cff7ae00"}],"id":"b06a6bad-f37b-4dc0-8d2b-807965a258e2","description":"This folder handles maintenance request workflows for equipment. It includes APIs for creating corrective and preventive maintenance requests, assigning technicians, updating request status through a Kanban workflow, completing tasks, and viewing maintenance schedules and history.
\n","_postman_id":"b06a6bad-f37b-4dc0-8d2b-807965a258e2"},{"name":"Teams","item":[{"name":"Teams","id":"db7575dc-b272-43a8-a226-c4c5309b0e31","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Creates a new maintenance team with a name and optional description. Teams are used to organize technicians and assign equipment.
\n","urlObject":{"protocol":"https","path":["api","teams"],"host":["odooxadani","onrender","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"db7575dc-b272-43a8-a226-c4c5309b0e31"},{"name":"get-teams","id":"1a1861ee-edf8-4cb5-a558-5d4f0b034601","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Fetches all maintenance teams along with their members and roles. Useful for team management and assignment overview.
\n","urlObject":{"protocol":"https","path":["api","teams"],"host":["odooxadani","onrender","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"1a1861ee-edf8-4cb5-a558-5d4f0b034601"},{"name":"get single-team","id":"98bd8e25-cc8f-4bf6-b1c0-6a07e8a563c8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Retrieves detailed information of a specific team, including its members and creation details.
\n","urlObject":{"protocol":"https","path":["api","teams","694fbcede42d3e817d2627a6"],"host":["odooxadani","onrender","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"98bd8e25-cc8f-4bf6-b1c0-6a07e8a563c8"},{"name":"add member","id":"6dbf323a-fae2-486c-ad35-ba20a0762763","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Adds an existing user to a maintenance team. Only Admin and Manager roles are authorized to perform this action.t
\n","urlObject":{"protocol":"https","path":["api","teams","694fbcede42d3e817d2627a6","add-member"],"host":["odooxadani","onrender","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"6dbf323a-fae2-486c-ad35-ba20a0762763"},{"name":"remove-member","id":"dfcb7ffb-e181-4e51-b304-d54b4c310b11","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Removes a user from a maintenance team. This action is restricted to Admin and Manager roles only.
\n","urlObject":{"protocol":"https","path":["api","teams","694fbcede42d3e817d2627a6","remove-member"],"host":["odooxadani","onrender","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"dfcb7ffb-e181-4e51-b304-d54b4c310b11"}],"id":"4190d01f-bd9c-40d4-b6b3-15949b69cd07","description":"This folder manages maintenance teams within the system. It allows administrators and managers to create teams, add or remove members, and retrieve team details to ensure proper assignment of technicians to equipment and maintenance requests.
\n","_postman_id":"4190d01f-bd9c-40d4-b6b3-15949b69cd07"},{"name":"dashboard","id":"bcfee99a-1fe7-41af-b244-a76baaf6d9dd","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Provides high-level system statistics including total maintenance requests, open issues, repaired tasks, and overdue requests.
\n","urlObject":{"protocol":"https","path":["api","reports","dashboard"],"host":["odooxadani","onrender","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"bcfee99a-1fe7-41af-b244-a76baaf6d9dd"},{"name":"request-by-team","id":"9e3f864e-dc72-49ba-b081-3d7040e8c47e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Returns a report showing the number of maintenance requests handled by each team. Accessible only to Admin and Manager roles.
\n","urlObject":{"protocol":"https","path":["api","reports","requests-by-team"],"host":["odooxadani","onrender","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"9e3f864e-dc72-49ba-b081-3d7040e8c47e"},{"name":"request-by-equiment","id":"e4b54124-cedd-49c2-98f2-0069fdd3dd00","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Generates a report displaying how many maintenance requests are associated with each equipment. Helps identify frequently failing assets.
\n","urlObject":{"protocol":"https","path":["api","reports","requests-by-equipment"],"host":["odooxadani","onrender","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"e4b54124-cedd-49c2-98f2-0069fdd3dd00"}]}