{"info":{"_postman_id":"cd97405b-0a37-43ed-abcc-d6f849c993ed","name":"KoppaKitsExchange API","description":"

Welcome to the KoppaKitsExchange API documentation. This API provides a comprehensive set of endpoints to facilitate user management, messaging, and item-related functionalities for Nigerian NYSC corp members. Developers can integrate these features seamlessly into their applications to enhance user experiences and streamline interactions within the KoppaExchange platform.

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"25574591","collectionId":"cd97405b-0a37-43ed-abcc-d6f849c993ed","publishedId":"2sA2rCUhQQ","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2024-02-24T15:43:04.000Z"},"item":[{"name":"Users","item":[{"name":"login","id":"8de38e65-db37-4357-a0a9-e691ed32af83","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"email\": \"test@mail.com\",\r\n \"password\": \"test1234\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://koppakitsexchange-api.onrender.com/api/v1/users/login","description":"

This API endpoint facilitates user authentication. It requires a JSON payload containing the user's email and password.

\n","urlObject":{"protocol":"https","path":["api","v1","users","login"],"host":["koppakitsexchange-api","onrender","com"],"query":[],"variable":[]}},"response":[{"id":"b2d3794f-9d73-47dd-9f6d-9008e20d9f7c","name":"login","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"email\": \"realtest@mail.com\",\r\n \"password\": \"test1234\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://koppakitsexchange-api.onrender.com/api/v1/users/login"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sun, 25 Feb 2024 11:45:00 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"CF-Ray","value":"85afb30defc203b9-LHR"},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"ETag","value":"W/\"f6-GY3UNIuiGWhBNL0LLgX6X8drQ0c\""},{"key":"Vary","value":"Accept-Encoding"},{"key":"rndr-id","value":"d3727242-ad6f-42b9"},{"key":"x-powered-by","value":"Express"},{"key":"x-render-origin-server","value":"Render"},{"key":"Server","value":"cloudflare"},{"key":"Content-Encoding","value":"br"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"message\": \"You have successfully signed in\",\n \"token\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjY1ZDlhMTY1NDFkOTdjOTM0MTAwMjQ0YSIsImlhdCI6MTcwODg2MTUwMCwiZXhwIjoxNzE2NjM3NTAwfQ._gDsHLfqvSJy4c4EaVkFNRYepcNAlvH9K9hpj-NKACw\"\n}"}],"_postman_id":"8de38e65-db37-4357-a0a9-e691ed32af83"},{"name":"logout","id":"032534a8-9080-4b80-82f3-c806d03ca09e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"GET","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://koppakitsexchange-api.onrender.com/api/v1/users/logout","description":"

Logging out is achieved through this endpoint, requiring Bearer Token authorization and a JSON payload containing the user's email and password.

\n","urlObject":{"protocol":"https","path":["api","v1","users","logout"],"host":["koppakitsexchange-api","onrender","com"],"query":[],"variable":[]}},"response":[{"id":"8ac249bb-73d4-44d2-9459-3c1252bdac27","name":"logout","originalRequest":{"method":"GET","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://koppakitsexchange-api.onrender.com/api/v1/users/logout"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sun, 25 Feb 2024 12:12:47 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"CF-Ray","value":"85afdbcd9b11d16c-LHR"},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"ETag","value":"W/\"46-br1PvNShZtqX33qbpRT51K+JZBw\""},{"key":"Vary","value":"Accept-Encoding"},{"key":"rndr-id","value":"cb6db158-404d-4356"},{"key":"x-powered-by","value":"Express"},{"key":"x-render-origin-server","value":"Render"},{"key":"Server","value":"cloudflare"},{"key":"Content-Encoding","value":"br"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"message\": \"You have successfully been logged out\"\n}"}],"_postman_id":"032534a8-9080-4b80-82f3-c806d03ca09e"},{"name":"getUsersByCamp","id":"c7f0c14c-54eb-4f0a-a17a-5e36cea48bbd","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"GET","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://koppakitsexchange-api.onrender.com/api/v1/users/camp","description":"

Retrieve a list of users based on their designated NYSC camp. Bearer Token authorization is essential for access.

\n","urlObject":{"protocol":"https","path":["api","v1","users","camp"],"host":["koppakitsexchange-api","onrender","com"],"query":[],"variable":[]}},"response":[{"id":"a7e1a68a-e2a2-4935-809a-71db958b5170","name":"getUsersByCamp","originalRequest":{"method":"GET","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://koppakitsexchange-api.onrender.com/api/v1/users/camp"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sun, 25 Feb 2024 11:51:28 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"CF-Ray","value":"85afbc901b4903b9-LHR"},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"ETag","value":"W/\"e5-4Yd8CVYcdlNMPowNM8u7TUjCPQ8\""},{"key":"Vary","value":"Accept-Encoding"},{"key":"rndr-id","value":"b2efd2b3-b8c5-40fa"},{"key":"x-powered-by","value":"Express"},{"key":"x-render-origin-server","value":"Render"},{"key":"Server","value":"cloudflare"},{"key":"Content-Encoding","value":"br"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"length\": 1,\n \"data\": [\n {\n \"location\": {\n \"type\": \"Point\",\n \"coordinates\": []\n },\n \"_id\": \"65d9a16541d97c934100244a\",\n \"name\": \"Nuel\",\n \"phoneNumber\": 81000000000,\n \"email\": \"realtest@mail.com\",\n \"NYSC_camp\": \"Osun\",\n \"active\": true,\n \"__v\": 0\n }\n ]\n}"}],"_postman_id":"c7f0c14c-54eb-4f0a-a17a-5e36cea48bbd"},{"name":"getAllUsers","id":"dabbdd9b-e1b5-4667-b3da-47c5e565a136","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"GET","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://koppakitsexchange-api.onrender.com/api/v1/users","description":"

Access a comprehensive list of all users through this endpoint, mandating Bearer Token authorization.

\n","urlObject":{"protocol":"https","path":["api","v1","users"],"host":["koppakitsexchange-api","onrender","com"],"query":[],"variable":[]}},"response":[{"id":"09338efd-a955-4c20-8491-63a95ccd8dd9","name":"getAllUsers","originalRequest":{"method":"GET","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://koppakitsexchange-api.onrender.com/api/v1/users"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sun, 25 Feb 2024 11:53:31 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"CF-Ray","value":"85afbf91df6003b9-LHR"},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"ETag","value":"W/\"543-tLB2F07Zp1omFV6pj35bKL8psh8\""},{"key":"Vary","value":"Accept-Encoding"},{"key":"rndr-id","value":"7d1a992e-9b4e-45e0"},{"key":"x-powered-by","value":"Express"},{"key":"x-render-origin-server","value":"Render"},{"key":"Server","value":"cloudflare"},{"key":"Content-Encoding","value":"br"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"length\": 7,\n \"data\": [\n {\n \"location\": {\n \"type\": \"Point\",\n \"coordinates\": []\n },\n \"_id\": \"65d3dba3498e289a39408a8a\",\n \"name\": \"Emmanuel\",\n \"email\": \"test@mail.com\",\n \"NYSC_camp\": \"Lagos\",\n \"__v\": 0,\n \"passwordResetToken\": \"993d4adc9a8837323bddcec92b5224177ff04f80b37f42760fdd05ff44bbbcbf\",\n \"passwordResetTokenExpires\": \"2024-02-24T08:12:53.797Z\",\n \"active\": true\n },\n {\n \"location\": {\n \"type\": \"Point\",\n \"coordinates\": []\n },\n \"active\": true,\n \"_id\": \"65d4b10b7c53e930b4d55564\",\n \"name\": \"test\",\n \"email\": \"test1@mail.com\",\n \"NYSC_camp\": \"Ogun\",\n \"__v\": 0\n },\n {\n \"location\": {\n \"type\": \"Point\",\n \"coordinates\": []\n },\n \"active\": true,\n \"_id\": \"65d4b17d7c53e930b4d55566\",\n \"name\": \"test\",\n \"email\": \"test2@mail.com\",\n \"NYSC_camp\": \"Lagos\",\n \"__v\": 0\n },\n {\n \"location\": {\n \"type\": \"Point\",\n \"coordinates\": []\n },\n \"active\": true,\n \"_id\": \"65d4b19d7c53e930b4d55568\",\n \"name\": \"test\",\n \"email\": \"test3@mail.com\",\n \"NYSC_camp\": \"Lagos\",\n \"__v\": 0\n },\n {\n \"location\": {\n \"type\": \"Point\",\n \"coordinates\": []\n },\n \"active\": true,\n \"_id\": \"65d4b23f7c53e930b4d5556a\",\n \"name\": \"test\",\n \"email\": \"test4@mail.com\",\n \"NYSC_camp\": \"Lagos\",\n \"__v\": 0\n },\n {\n \"location\": {\n \"coordinates\": [\n -29,\n 298\n ],\n \"type\": \"Point\"\n },\n \"active\": true,\n \"_id\": \"65d4b26a7c53e930b4d5556c\",\n \"name\": \"test\",\n \"email\": \"test5@mail.com\",\n \"NYSC_camp\": \"Lagos\",\n \"__v\": 0\n },\n {\n \"location\": {\n \"type\": \"Point\",\n \"coordinates\": []\n },\n \"_id\": \"65d9a16541d97c934100244a\",\n \"name\": \"Nuel\",\n \"phoneNumber\": 81000000000,\n \"email\": \"realtest@mail.com\",\n \"NYSC_camp\": \"Osun\",\n \"active\": true,\n \"__v\": 0\n }\n ]\n}"}],"_postman_id":"dabbdd9b-e1b5-4667-b3da-47c5e565a136"},{"name":"getAllUsers with Parameters","id":"7f49e8d5-2ef1-412d-9f0b-2c33094b2556","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"GET","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://koppakitsexchange-api.onrender.com/api/v1/users?page=1&limit=5","description":"

Access a comprehensive list of all users through this endpoint, mandating Bearer Token authorization.

The users' data can be paginated with the below accepted parameters

\n","urlObject":{"protocol":"https","path":["api","v1","users"],"host":["koppakitsexchange-api","onrender","com"],"query":[{"key":"page","value":"1"},{"key":"limit","value":"5"}],"variable":[]}},"response":[{"id":"37a72ebc-e3a6-4cfa-ac49-40dfdc3ac14d","name":"getAllUsers with Parameters","originalRequest":{"method":"GET","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":{"raw":"https://koppakitsexchange-api.onrender.com/api/v1/users?page=1&limit=5","protocol":"https","host":["koppakitsexchange-api","onrender","com"],"path":["api","v1","users"],"query":[{"key":"page","value":"1"},{"key":"limit","value":"5"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Security-Policy","value":"default-src 'self';base-uri 'self';font-src 'self' https: data:;form-action 'self';frame-ancestors 'self';img-src 'self' data:;object-src 'none';script-src 'self';script-src-attr 'none';style-src 'self' https: 'unsafe-inline';upgrade-insecure-requests"},{"key":"Cross-Origin-Opener-Policy","value":"same-origin"},{"key":"Cross-Origin-Resource-Policy","value":"same-origin"},{"key":"Origin-Agent-Cluster","value":"?1"},{"key":"Referrer-Policy","value":"no-referrer"},{"key":"Strict-Transport-Security","value":"max-age=15552000; includeSubDomains"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-DNS-Prefetch-Control","value":"off"},{"key":"X-Download-Options","value":"noopen"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-Permitted-Cross-Domain-Policies","value":"none"},{"key":"X-XSS-Protection","value":"0"},{"key":"X-RateLimit-Limit","value":"50"},{"key":"X-RateLimit-Remaining","value":"46"},{"key":"Date","value":"Mon, 26 Feb 2024 11:47:37 GMT"},{"key":"X-RateLimit-Reset","value":"1708948836"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"990"},{"key":"ETag","value":"W/\"3de-/CzxCKsU1rUaToKAMxuyIrAWg48\""},{"key":"Vary","value":"Accept-Encoding"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"length\": 5,\n \"data\": [\n {\n \"location\": {\n \"type\": \"Point\",\n \"coordinates\": []\n },\n \"_id\": \"65d3dba3498e289a39408a8a\",\n \"name\": \"Emmanuel\",\n \"email\": \"test@mail.com\",\n \"NYSC_camp\": \"Lagos\",\n \"__v\": 0,\n \"passwordResetToken\": \"2fa5dcaee39baebc472d9ca18afb051973a3fe142080296995953d6c08a75289\",\n \"passwordResetTokenExpires\": \"2024-02-25T12:12:16.729Z\",\n \"active\": true\n },\n {\n \"location\": {\n \"type\": \"Point\",\n \"coordinates\": []\n },\n \"active\": true,\n \"_id\": \"65d4b10b7c53e930b4d55564\",\n \"name\": \"test\",\n \"email\": \"test1@mail.com\",\n \"NYSC_camp\": \"Ogun\",\n \"__v\": 0\n },\n {\n \"location\": {\n \"type\": \"Point\",\n \"coordinates\": []\n },\n \"active\": true,\n \"_id\": \"65d4b17d7c53e930b4d55566\",\n \"name\": \"test\",\n \"email\": \"test2@mail.com\",\n \"NYSC_camp\": \"Lagos\",\n \"__v\": 0\n },\n {\n \"location\": {\n \"type\": \"Point\",\n \"coordinates\": []\n },\n \"active\": true,\n \"_id\": \"65d4b19d7c53e930b4d55568\",\n \"name\": \"test\",\n \"email\": \"test3@mail.com\",\n \"NYSC_camp\": \"Lagos\",\n \"__v\": 0\n },\n {\n \"location\": {\n \"type\": \"Point\",\n \"coordinates\": []\n },\n \"active\": true,\n \"_id\": \"65d4b23f7c53e930b4d5556a\",\n \"name\": \"test\",\n \"email\": \"test4@mail.com\",\n \"NYSC_camp\": \"Lagos\",\n \"__v\": 0\n }\n ]\n}"}],"_postman_id":"7f49e8d5-2ef1-412d-9f0b-2c33094b2556"},{"name":"signup","id":"8e95df52-f6d3-49f3-8105-18917927ae3f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"email\": \"newtest@mail.com\",\r\n \"name\": \"Nuel 3\",\r\n \"phoneNumber\": \"081000000002\",\r\n \"NYSC_camp\": \"Lagos\",\r\n \"password\":\"test1234\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://koppakitsexchange-api.onrender.com/api/v1/users/signup","description":"

Register a new user by providing a JSON payload containing essential details such as email, name, phone number, NYSC camp, location (coordinates) in format [longitude latitude] and password.

\n","urlObject":{"protocol":"https","path":["api","v1","users","signup"],"host":["koppakitsexchange-api","onrender","com"],"query":[],"variable":[]}},"response":[{"id":"05a3d9b7-dc11-467e-b6f4-4872b85a3db2","name":"signup","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"email\": \"newtest@mail.com\",\r\n \"name\": \"Nuel 3\",\r\n \"phoneNumber\": \"081000000002\",\r\n \"NYSC_camp\": \"Lagos\",\r\n \"password\":\"test1234\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://koppakitsexchange-api.onrender.com/api/v1/users/signup"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sun, 25 Feb 2024 12:10:14 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"CF-Ray","value":"85afd8010bbbd16c-LHR"},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"ETag","value":"W/\"15b-PGWDKv22SiB842euA4Wx4uCCqog\""},{"key":"Vary","value":"Accept-Encoding"},{"key":"rndr-id","value":"7ba0db17-9f14-436b"},{"key":"x-powered-by","value":"Express"},{"key":"x-render-origin-server","value":"Render"},{"key":"Server","value":"cloudflare"},{"key":"Content-Encoding","value":"br"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"message\": \"Your account has been created successfully\",\n \"data\": {\n \"name\": \"Nuel 3\",\n \"password\": \"$2b$12$YfQGkSTTI2LInM203Vgx5e0NwhKxpyshzOL0QWMxMRcJwCbBHCeXW\",\n \"phoneNumber\": 81000000002,\n \"email\": \"newtest@mail.com\",\n \"NYSC_camp\": \"Lagos\",\n \"location\": {\n \"type\": \"Point\",\n \"coordinates\": []\n },\n \"active\": true,\n \"_id\": \"65db2e249bd201d050644b9b\",\n \"__v\": 0\n }\n}"}],"_postman_id":"8e95df52-f6d3-49f3-8105-18917927ae3f"},{"name":"forget password","id":"ec042d2f-8501-456a-acf8-8ee463200e13","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"email\": \"test@mail.com\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://koppakitsexchange-api.onrender.com/api/v1/users/forget-password","description":"

Initiate the password recovery process by submitting the user's email in the JSON payload.

\n","urlObject":{"protocol":"https","path":["api","v1","users","forget-password"],"host":["koppakitsexchange-api","onrender","com"],"query":[],"variable":[]}},"response":[{"id":"0679fec0-e5ab-468c-908d-ca840363c405","name":"forget password","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"email\": \"test@mail.com\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://koppakitsexchange-api.onrender.com/api/v1/users/forget-password"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sun, 25 Feb 2024 12:00:19 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"CF-Ray","value":"85afc987794103b9-LHR"},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"ETag","value":"W/\"57-O0O1Ynu2j9oBkeEDBCPL63kizuw\""},{"key":"Vary","value":"Accept-Encoding"},{"key":"rndr-id","value":"5b8ae80a-7f8a-4e2e"},{"key":"x-powered-by","value":"Express"},{"key":"x-render-origin-server","value":"Render"},{"key":"Server","value":"cloudflare"},{"key":"Content-Encoding","value":"br"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"message\": \"Your password link has been sent to your email address\"\n}"}],"_postman_id":"ec042d2f-8501-456a-acf8-8ee463200e13"},{"name":"reset password","id":"25fd2368-d8f9-4829-a9fa-e1673cef9e91","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"password\": \"test1234\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://koppakitsexchange-api.onrender.com/api/v1/users/reset-password/bb3d866ddea45a9e266cdc38f709a3dbcb6fc0bf4a743efe669223dc5d461c0e","description":"

Reset a user's password by providing the new password in the JSON payload, this endpoint is gotten via provided email through the forget password endpoint.

\n","urlObject":{"protocol":"https","path":["api","v1","users","reset-password","bb3d866ddea45a9e266cdc38f709a3dbcb6fc0bf4a743efe669223dc5d461c0e"],"host":["koppakitsexchange-api","onrender","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"25fd2368-d8f9-4829-a9fa-e1673cef9e91"},{"name":"deleteAccount","id":"2b8e9bc4-4657-428e-9710-e614ca2f5649","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"DELETE","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://koppakitsexchange-api.onrender.com/api/v1/users/delete/65d9a16541d97c934100244a","description":"

Delete a user account with Bearer Token authorization, accompanied by the user's password in the JSON payload.

\n","urlObject":{"protocol":"https","path":["api","v1","users","delete","65d9a16541d97c934100244a"],"host":["koppakitsexchange-api","onrender","com"],"query":[],"variable":[]}},"response":[{"id":"1c4df6f3-1efc-496d-8268-0eed8147fd9b","name":"deleteAccount","originalRequest":{"method":"DELETE","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://koppakitsexchange-api.onrender.com/api/v1/users/delete/65d9a16541d97c934100244a"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sun, 25 Feb 2024 12:05:57 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"CF-Ray","value":"85afd1c7595803b9-LHR"},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"ETag","value":"W/\"4c-6t/WKkyKR8UdkOwleJwQaHqZEd4\""},{"key":"Vary","value":"Accept-Encoding"},{"key":"rndr-id","value":"6dd7523d-fc96-4c71"},{"key":"x-powered-by","value":"Express"},{"key":"x-render-origin-server","value":"Render"},{"key":"Server","value":"cloudflare"},{"key":"Content-Encoding","value":"br"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"message\": \"Your account has been deleted successfully.\"\n}"}],"_postman_id":"2b8e9bc4-4657-428e-9710-e614ca2f5649"}],"id":"32c0dc7f-1df3-4516-9c26-1e0d56d64504","description":"

Authentication and Account Management

Logout: Securely log users out with Bearer Token authorization.

Get Users By Camp: Retrieve a list of users based on their designated NYSC camp.

Get All Users: Access a comprehensive list of all users.

Signup: Register new users by providing essential details.

Forget Password: Initiate the password recovery process.

Reset Password: Change a user's password securely.

Delete Account: Permanently delete a user account.

\n","_postman_id":"32c0dc7f-1df3-4516-9c26-1e0d56d64504"},{"name":"Messages","item":[{"name":"getUser Messages","id":"58bf07df-6c69-4e92-810c-995d38df088f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"GET","header":[],"url":"https://koppakitsexchange-api.onrender.com/api/v1/users/65d3dba3498e289a39408a8a/messages","description":"

Retrieve messages for a specific user with Bearer Token authorization, the params is the id of the user which messages will be sent to.

\n","urlObject":{"protocol":"https","path":["api","v1","users","65d3dba3498e289a39408a8a","messages"],"host":["koppakitsexchange-api","onrender","com"],"query":[],"variable":[]}},"response":[{"id":"01e7604c-57bc-4b8f-b801-f9415bdfef78","name":"getUser Messages","originalRequest":{"method":"GET","header":[],"url":"https://koppakitsexchange-api.onrender.com/api/v1/users/65d3dba3498e289a39408a8a/messages"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sun, 25 Feb 2024 11:58:15 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"CF-Ray","value":"85afc67fba3303b9-LHR"},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"ETag","value":"W/\"239-Evi7Cm/Y3vtHweqtLenP/owmsVQ\""},{"key":"Vary","value":"Accept-Encoding"},{"key":"rndr-id","value":"aab9fb10-cb64-46cc"},{"key":"x-powered-by","value":"Express"},{"key":"x-render-origin-server","value":"Render"},{"key":"Server","value":"cloudflare"},{"key":"Content-Encoding","value":"br"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"messages\": [\n {\n \"_id\": \"65d759d2bed625b3c16550c3\",\n \"message\": \"Hello world 2\",\n \"time\": \"2024-02-22T14:24:53.499Z\",\n \"name\": \"65d3dba3498e289a39408a8a\",\n \"__v\": 0\n },\n {\n \"_id\": \"65d75a28bed625b3c16550c5\",\n \"message\": \"Hello world 2 new\",\n \"time\": \"2024-02-22T14:24:53.499Z\",\n \"name\": \"65d3dba3498e289a39408a8a\",\n \"__v\": 0\n },\n {\n \"_id\": \"65d769f5afd34bde5baac5af\",\n \"time\": \"2024-02-22T15:36:08.341Z\",\n \"name\": \"65d3dba3498e289a39408a8a\",\n \"__v\": 0\n },\n {\n \"_id\": \"65d9a9971fd688d21d5669c2\",\n \"message\": \"This is another testing\",\n \"time\": \"2024-02-24T08:28:02.487Z\",\n \"name\": \"65d3dba3498e289a39408a8a\",\n \"__v\": 0\n }\n ]\n}"}],"_postman_id":"58bf07df-6c69-4e92-810c-995d38df088f"},{"name":"postUser Messages","id":"b92360ac-4e90-4edf-9eaa-a0e3dce19ded","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"message\": \"This is new test messaging text\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://koppakitsexchange-api.onrender.com/api/v1/users/65d3dba3498e289a39408a8a/messages","description":"

Post a new message for a user with Bearer Token authorization. Include the message content in the JSON payload.

User Communication

Get User Messages: Retrieve messages for a specific user.

Post User Messages: Send new messages to a user.

\n","_postman_id":"3732bfd0-03b1-4dc8-ac1a-25b858d7cbf4"},{"name":"Items","item":[{"name":"getItemsByCamp","id":"812e258e-2e89-4cd9-ae80-a225b0e48ca3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"GET","header":[],"url":"https://koppakitsexchange-api.onrender.com/api/v1/items/camp","description":"

Obtain a list of items based on the user's camp. Bearer Token authorization is required.

\n","urlObject":{"protocol":"https","path":["api","v1","items","camp"],"host":["koppakitsexchange-api","onrender","com"],"query":[],"variable":[]}},"response":[{"id":"38c65506-3cd7-48da-a98e-6697b8c96070","name":"getItemsByCamp","originalRequest":{"method":"GET","header":[],"url":"https://koppakitsexchange-api.onrender.com/api/v1/items/camp"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sun, 25 Feb 2024 11:55:05 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"CF-Ray","value":"85afc1deca6b03b9-LHR"},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"ETag","value":"W/\"8d0-JzbO2OKn87Ng5JpKt262wkoGpBo\""},{"key":"Vary","value":"Accept-Encoding"},{"key":"rndr-id","value":"470ed39a-059d-4613"},{"key":"x-powered-by","value":"Express"},{"key":"x-render-origin-server","value":"Render"},{"key":"Server","value":"cloudflare"},{"key":"Content-Encoding","value":"br"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"length\": 3,\n \"data\": [\n {\n \"_id\": \"65d9fdef1fd688d21d5669d2\",\n \"images\": [\n {\n \"fieldname\": \"images\",\n \"originalname\": \"Colors.jpeg\",\n \"encoding\": \"7bit\",\n \"mimetype\": \"image/jpeg\",\n \"destination\": \"./public/img/items\",\n \"filename\": \"1708785135880--7367Colors.jpeg\",\n \"path\": \"public\\\\img\\\\items\\\\1708785135880--7367Colors.jpeg\",\n \"size\": 247364\n },\n {\n \"fieldname\": \"images\",\n \"originalname\": \"logo-removebg-preview.png\",\n \"encoding\": \"7bit\",\n \"mimetype\": \"image/png\",\n \"destination\": \"./public/img/items\",\n \"filename\": \"1708785135912--454logo-removebg-preview.png\",\n \"path\": \"public\\\\img\\\\items\\\\1708785135912--454logo-removebg-preview.png\",\n \"size\": 57364\n }\n ],\n \"size\": 45,\n \"status\": \"searching\",\n \"owner\": {\n \"_id\": \"65d9a16541d97c934100244a\",\n \"NYSC_camp\": \"Osun\"\n },\n \"description\": \"This is testing\",\n \"kit_type\": \"shoe\",\n \"__v\": 0\n },\n {\n \"_id\": \"65d9fe64487d8c42206a8d3e\",\n \"images\": [\n {\n \"fieldname\": \"images\",\n \"originalname\": \"Colors.jpeg\",\n \"encoding\": \"7bit\",\n \"mimetype\": \"image/jpeg\",\n \"destination\": \"./public/img/items\",\n \"filename\": \"1708785252341--5520Colors.jpeg\",\n \"path\": \"public\\\\img\\\\items\\\\1708785252341--5520Colors.jpeg\",\n \"size\": 247364\n },\n {\n \"fieldname\": \"images\",\n \"originalname\": \"logo-removebg-preview.png\",\n \"encoding\": \"7bit\",\n \"mimetype\": \"image/png\",\n \"destination\": \"./public/img/items\",\n \"filename\": \"1708785252361--276logo-removebg-preview.png\",\n \"path\": \"public\\\\img\\\\items\\\\1708785252361--276logo-removebg-preview.png\",\n \"size\": 57364\n }\n ],\n \"size\": 45,\n \"status\": \"searching\",\n \"owner\": {\n \"_id\": \"65d9a16541d97c934100244a\",\n \"NYSC_camp\": \"Osun\"\n },\n \"description\": \"This is testing\",\n \"kit_type\": \"shoe\",\n \"__v\": 0\n },\n {\n \"_id\": \"65da0651b9d8a7b347d14c7f\",\n \"images\": [\n {\n \"fieldname\": \"images\",\n \"originalname\": \"Colors.jpeg\",\n \"encoding\": \"7bit\",\n \"mimetype\": \"image/jpeg\",\n \"destination\": \"./public/img/items\",\n \"filename\": \"1708787281605--1685Colors.jpeg\",\n \"path\": \"public\\\\img\\\\items\\\\1708787281605--1685Colors.jpeg\",\n \"size\": 247364\n },\n {\n \"fieldname\": \"images\",\n \"originalname\": \"logo-removebg-preview.png\",\n \"encoding\": \"7bit\",\n \"mimetype\": \"image/png\",\n \"destination\": \"./public/img/items\",\n \"filename\": \"1708787281611--7171logo-removebg-preview.png\",\n \"path\": \"public\\\\img\\\\items\\\\1708787281611--7171logo-removebg-preview.png\",\n \"size\": 57364\n }\n ],\n \"shoe_size\": 45,\n \"wanted_shoe_size\": 50,\n \"status\": \"searching\",\n \"owner\": {\n \"_id\": \"65d9a16541d97c934100244a\",\n \"NYSC_camp\": \"Osun\"\n },\n \"description\": \"This is testing\",\n \"kit_type\": \"shoe\",\n \"__v\": 0\n }\n ]\n}"}],"_postman_id":"812e258e-2e89-4cd9-ae80-a225b0e48ca3"},{"name":"getItemsByStatus","id":"4eeea634-fa15-4d5c-9d71-0065f31de029","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{jwt}}"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"status\": \"paired\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://koppakitsexchange-api.onrender.com/api/v1/items/status","description":"

Filter items by status with Bearer Token authorization. Provide the desired status in the JSON payload. The desired status are ['searching' 'pairing' 'paired']

\n","urlObject":{"protocol":"https","path":["api","v1","items","status"],"host":["koppakitsexchange-api","onrender","com"],"query":[],"variable":[]}},"response":[{"id":"9f236751-6550-42d7-88e0-1d419909969a","name":"getItemsByStatus","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"status\": \"paired\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://koppakitsexchange-api.onrender.com/api/v1/items/status"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sun, 25 Feb 2024 11:57:23 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"CF-Ray","value":"85afc53dca6903b9-LHR"},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"ETag","value":"W/\"322-uUIgtB03v9dVpeX6SqOZw6uVoyk\""},{"key":"Vary","value":"Accept-Encoding"},{"key":"rndr-id","value":"54dae4b8-2c1b-4365"},{"key":"x-powered-by","value":"Express"},{"key":"x-render-origin-server","value":"Render"},{"key":"Server","value":"cloudflare"},{"key":"Content-Encoding","value":"br"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"length\": 1,\n \"data\": [\n {\n \"_id\": \"65db2affc3001ed5998972a5\",\n \"images\": [\n {\n \"fieldname\": \"images\",\n \"originalname\": \"Colors.jpeg\",\n \"encoding\": \"7bit\",\n \"mimetype\": \"image/jpeg\",\n \"destination\": \"./public/img/items\",\n \"filename\": \"1708862206724--1894Colors.jpeg\",\n \"path\": \"public/img/items/1708862206724--1894Colors.jpeg\",\n \"size\": 247364\n },\n {\n \"fieldname\": \"images\",\n \"originalname\": \"logo-removebg-preview.png\",\n \"encoding\": \"7bit\",\n \"mimetype\": \"image/png\",\n \"destination\": \"./public/img/items\",\n \"filename\": \"1708862207050--1240logo-removebg-preview.png\",\n \"path\": \"public/img/items/1708862207050--1240logo-removebg-preview.png\",\n \"size\": 57364\n }\n ],\n \"shoe_size\": 40,\n \"wanted_shoe_size\": 43,\n \"status\": \"paired\",\n \"owner\": {\n \"_id\": \"65d9a16541d97c934100244a\",\n \"phoneNumber\": 81000000000\n },\n \"description\": \"This is a new testing\",\n \"kit_type\": \"shoe\",\n \"__v\": 0\n }\n ]\n}"}],"_postman_id":"4eeea634-fa15-4d5c-9d71-0065f31de029"},{"name":"createItem","id":"687974ee-d521-4d98-b76c-e96f659335fb","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{jwt}}"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"images","type":"file","src":["Colors.jpeg","logo-removebg-preview.png"]},{"key":"shoe_size","value":"40","type":"text"},{"key":"status","value":"paired","type":"text"},{"key":"description","value":"This is a new testing","type":"text"},{"key":"kit_type","value":"shoe","type":"text"},{"key":"wanted_shoe_size","value":"43","type":"text"}]},"url":"https://koppakitsexchange-api.onrender.com/api/v1/items","description":"

Create a new item with Bearer Token authorization. Ensure all necessary details are included in the request. If clothing, the query string for clothing_size and wanted_clothing_size will be of type String and enum of ['small', 'medium', 'large', 'extra-large'] while the query string for shoe_size and wanted_clothing_size will be of type Number.

\n","urlObject":{"protocol":"https","path":["api","v1","items"],"host":["koppakitsexchange-api","onrender","com"],"query":[],"variable":[]}},"response":[{"id":"a9c94828-a4b8-4cd3-879e-056137af7620","name":"createItem","originalRequest":{"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"images","type":"file","src":["Colors.jpeg","logo-removebg-preview.png"]},{"key":"shoe_size","value":"40","type":"text"},{"key":"status","value":"paired","type":"text"},{"key":"description","value":"This is a new testing","type":"text"},{"key":"kit_type","value":"shoe","type":"text"},{"key":"wanted_shoe_size","value":"43","type":"text"}]},"url":"https://koppakitsexchange-api.onrender.com/api/v1/items"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sun, 25 Feb 2024 11:56:47 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"CF-Ray","value":"85afc44fccd503b9-LHR"},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"ETag","value":"W/\"3f4-B1GMzIkGk7VnHZRsow4iHa7zijw\""},{"key":"Vary","value":"Accept-Encoding"},{"key":"rndr-id","value":"c0e7cf81-c175-4168"},{"key":"x-powered-by","value":"Express"},{"key":"x-render-origin-server","value":"Render"},{"key":"Server","value":"cloudflare"},{"key":"Content-Encoding","value":"br"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"item submitted successfully\",\n \"data\": {\n \"images\": [\n {\n \"fieldname\": \"images\",\n \"originalname\": \"Colors.jpeg\",\n \"encoding\": \"7bit\",\n \"mimetype\": \"image/jpeg\",\n \"destination\": \"./public/img/items\",\n \"filename\": \"1708862206724--1894Colors.jpeg\",\n \"path\": \"public/img/items/1708862206724--1894Colors.jpeg\",\n \"size\": 247364\n },\n {\n \"fieldname\": \"images\",\n \"originalname\": \"logo-removebg-preview.png\",\n \"encoding\": \"7bit\",\n \"mimetype\": \"image/png\",\n \"destination\": \"./public/img/items\",\n \"filename\": \"1708862207050--1240logo-removebg-preview.png\",\n \"path\": \"public/img/items/1708862207050--1240logo-removebg-preview.png\",\n \"size\": 57364\n }\n ],\n \"shoe_size\": 40,\n \"wanted_shoe_size\": 43,\n \"status\": \"paired\",\n \"owner\": {\n \"location\": {\n \"type\": \"Point\",\n \"coordinates\": []\n },\n \"_id\": \"65d9a16541d97c934100244a\",\n \"name\": \"Nuel\",\n \"password\": \"$2b$12$kXOD9/8VjygeJ.lW9i4Olu.PEobXbrDj5oqEz7Cy51VmrV2T59wFG\",\n \"phoneNumber\": 81000000000,\n \"email\": \"realtest@mail.com\",\n \"NYSC_camp\": \"Osun\",\n \"active\": true,\n \"__v\": 0\n },\n \"description\": \"This is a new testing\",\n \"kit_type\": \"shoe\",\n \"_id\": \"65db2affc3001ed5998972a5\",\n \"__v\": 0\n }\n}"}],"_postman_id":"687974ee-d521-4d98-b76c-e96f659335fb"}],"id":"a97ae2f9-dd05-4846-b459-b5ac5e586a17","description":"

Item Management

Get Items By Camp: Obtain a list of items based on the user's NSYC camp.

Get Items By Status: Filter items by status ['searching' 'pairing' 'paired'].

Create Item: Add a new item to the platform.

\n","_postman_id":"a97ae2f9-dd05-4846-b459-b5ac5e586a17"}]}