{"info":{"_postman_id":"bef9fc29-9217-46c1-9454-b79fc7f76a39","name":"EVVA Construction Area Project","description":"

API documentation for SVG Construction Area Project

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"11132962","collectionId":"bef9fc29-9217-46c1-9454-b79fc7f76a39","publishedId":"2sB2x3msVt","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2025-06-17T08:56:22.000Z"},"item":[{"name":"Auth","item":[{"name":"Login","event":[{"listen":"test","script":{"id":"d18d378a-a62c-4d80-b073-bc03152cdf27","exec":["pm.test(\"Your test name\", function () {"," var jsonData = pm.response.json();"," var token = jsonData.tokens.access.token;"," pm.collectionVariables.set(\"TOKEN\", token);","});"],"type":"text/javascript","packages":{}}}],"id":"d2b2b031-9b21-4e76-b396-f729e01083f8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"email\": \"email@email.com\",\n \"password\": \"Examplepassword1!\"\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:4000/v1/auth/login","description":"

Successful repsonse is account information of the user. It can vary according to the user role. Different responses of roles can be seen in the examples section.

\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"bef9fc29-9217-46c1-9454-b79fc7f76a39","id":"bef9fc29-9217-46c1-9454-b79fc7f76a39","name":"EVVA Construction Area Project","type":"collection"}},"urlObject":{"path":["auth","login"],"host":["http://localhost:4000/v1"],"query":[],"variable":[]}},"response":[{"id":"7b89b54a-e0b9-4889-80d4-46096458070e","name":"Superuser response","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"email\": \"email@email.com\",\n \"password\": \"Strongpassword1!\"\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:4000/v1/auth/login"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Security-Policy","value":"default-src 'self';base-uri 'self';block-all-mixed-content;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-Embedder-Policy","value":"require-corp"},{"key":"Cross-Origin-Opener-Policy","value":"same-origin"},{"key":"Cross-Origin-Resource-Policy","value":"same-origin"},{"key":"X-DNS-Prefetch-Control","value":"off"},{"key":"Expect-CT","value":"max-age=0"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"Strict-Transport-Security","value":"max-age=15552000; includeSubDomains"},{"key":"X-Download-Options","value":"noopen"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"Origin-Agent-Cluster","value":"?1"},{"key":"X-Permitted-Cross-Domain-Policies","value":"none"},{"key":"Referrer-Policy","value":"no-referrer"},{"key":"X-XSS-Protection","value":"0"},{"key":"Vary","value":"Origin, Accept-Encoding"},{"key":"Access-Control-Allow-Credentials","value":"true"},{"key":"Set-Cookie","value":"access_token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiI2ODQ2YTg3MDM5NmNjMjkwOTQyYWVmNzUiLCJpYXQiOjE3NDk0NjEyOTIsImV4cCI6MTc1MDA2NjA5MiwidHlwZSI6ImFjY2VzcyJ9.UglZwO23nZTOn8u9Uo14yQtoS6FwjsOrC82gP9dmcgs; Path=/; Expires=Mon, 16 Jun 2025 09:28:12 GMT; HttpOnly; SameSite=Strict"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"575"},{"key":"ETag","value":"W/\"23f-nd+I+5Z1RIuSFRH8iXTUHDjmkqc\""},{"key":"Date","value":"Mon, 09 Jun 2025 09:28:12 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"user\": {\n \"email\": \"email@email.com\",\n \"username\": \"superuser\",\n \"role\": \"superuser\",\n \"isEmailVerified\": true,\n \"isFirstTimeLogin\": false,\n \"correspondenceLanguageCode\": \"de-DE\",\n \"userType\": \"Superuser\",\n \"isActive\": true,\n \"additionalInformation\": \"\",\n \"createdAt\": \"2025-06-09T09:25:04.772Z\",\n \"id\": \"6846a870396cc290942aed75\"\n },\n \"tokens\": {\n \"access\": {\n \"token\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VySWQiOiI2NjVmYmYxMDYzY2Y1OTAwMTIzNDU2NyIsInVzZXJuYW1lIjoiZXhhbXBsZXVzZXIiLCJpYXQiOjE3MTc3MDA4MDAsImV4cCI6MTcxNzc4NzIwMH0.Wa9LZJ3qF_K7O8gqVb7K6_93WoMEOIfR_7n28YdDdXk\",\n \"expires\": \"2025-06-16T09:28:12.953Z\"\n }\n }\n}"},{"id":"3362b169-1df0-4026-94fb-ec4b8b06fd97","name":"Construction Manager response","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"email\": \"email@email.com\",\n \"password\": \"Examplepassword1!\"\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:4000/v1/auth/login"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Security-Policy","value":"default-src 'self';base-uri 'self';block-all-mixed-content;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-Embedder-Policy","value":"require-corp"},{"key":"Cross-Origin-Opener-Policy","value":"same-origin"},{"key":"Cross-Origin-Resource-Policy","value":"same-origin"},{"key":"X-DNS-Prefetch-Control","value":"off"},{"key":"Expect-CT","value":"max-age=0"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"Strict-Transport-Security","value":"max-age=15552000; includeSubDomains"},{"key":"X-Download-Options","value":"noopen"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"Origin-Agent-Cluster","value":"?1"},{"key":"X-Permitted-Cross-Domain-Policies","value":"none"},{"key":"Referrer-Policy","value":"no-referrer"},{"key":"X-XSS-Protection","value":"0"},{"key":"Vary","value":"Origin, Accept-Encoding"},{"key":"Access-Control-Allow-Credentials","value":"true"},{"key":"Set-Cookie","value":"access_token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiI2ODQ2YWYyNTM5NmNjMjkwOTQyYWYxMTciLCJpYXQiOjE3NDk0NjMwNjYsImV4cCI6MTc1MDA2Nzg2NiwidHlwZSI6ImFjY2VzcyJ9.jhHx6R-QYgOq19cPFCexTugRph8XVNBxjA9_wiXJW3k; Path=/; Expires=Mon, 16 Jun 2025 09:57:46 GMT; HttpOnly; SameSite=Strict"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"993"},{"key":"ETag","value":"W/\"3e1-CuTLONvdrw25Gjzr0adqy1pgaPc\""},{"key":"Date","value":"Mon, 09 Jun 2025 09:57:46 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"user\": {\n \"firstName\": \"Name\",\n \"lastName\": \"LastName\",\n \"evvaPersonId\": 1269930,\n \"limits\": {\n \"phone\": 1,\n \"RFIDmedium\": 1,\n \"id\": \"6846af25396cc290942af116\"\n },\n \"phoneNumber\": \"+491111111111\",\n \"constructionAreas\": [\n \"6846ae71396cc290942af0ce\"\n ],\n \"email\": \"email@email.com\",\n \"username\": \"username1\",\n \"role\": \"constructionManager\",\n \"createdBy\": \"6846a870396cc290942aef75\",\n \"isEmailVerified\": true,\n \"isFirstTimeLogin\": false,\n \"correspondenceLanguageCode\": \"de-DE\",\n \"userType\": \"ConstructionManager\",\n \"isActive\": true,\n \"additionalInformation\": \"Additional information\",\n \"phones\": [],\n \"RFIDmediums\": [],\n \"lockAccessAssignmentsWithEvvaAuthorizationReflections\": [],\n \"favoriteLockingComponentsPerConstructionArea\": [],\n \"createdAt\": \"2025-06-09T09:53:41.357Z\",\n \"id\": \"6846af25396cc290942af117\"\n },\n \"tokens\": {\n \"access\": {\n \"token\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiI2ODQ2YWYyNTM5NmNjMjkwOTQyYWYxMTciLCJpYXQiOjE3NDk0NjMwNjYsImV4cCI6MTc1MDA2Nzg2NiwidHlwZSI6ImFjY2VzcyJ9.jhHx6R-QYgOq19cPFCexTugRph8XVNBxjA9_wiXJW3k\",\n \"expires\": \"2025-06-16T09:57:46.041Z\"\n }\n }\n}"},{"id":"df8c646c-5514-4ea3-811c-5ec82d24ead9","name":"Subcontractor Company response","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"email\": \"erinc.polat+subcontractor1@gmail.com\",\n \"password\": \"Examplepassword1!\"\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:4000/v1/auth/login"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Security-Policy","value":"default-src 'self';base-uri 'self';block-all-mixed-content;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-Embedder-Policy","value":"require-corp"},{"key":"Cross-Origin-Opener-Policy","value":"same-origin"},{"key":"Cross-Origin-Resource-Policy","value":"same-origin"},{"key":"X-DNS-Prefetch-Control","value":"off"},{"key":"Expect-CT","value":"max-age=0"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"Strict-Transport-Security","value":"max-age=15552000; includeSubDomains"},{"key":"X-Download-Options","value":"noopen"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"Origin-Agent-Cluster","value":"?1"},{"key":"X-Permitted-Cross-Domain-Policies","value":"none"},{"key":"Referrer-Policy","value":"no-referrer"},{"key":"X-XSS-Protection","value":"0"},{"key":"Vary","value":"Origin, Accept-Encoding"},{"key":"Access-Control-Allow-Credentials","value":"true"},{"key":"Set-Cookie","value":"access_token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiI2ODQ2YWUxMjM5NmNjMjkwOTQyYWYwYTAiLCJpYXQiOjE3NDk0NjMyMzgsImV4cCI6MTc1MDA2ODAzOCwidHlwZSI6ImFjY2VzcyJ9.Ha0Pm4mKMHzGP5d7OkH7kXwEGwsZ9_jxMknUMIiQd7I; Path=/; Expires=Mon, 16 Jun 2025 10:00:38 GMT; HttpOnly; SameSite=Strict"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"ETag","value":"W/\"46a-/1B9CBIea/AtXFuc/HNy+pBmAfk\""},{"key":"Content-Encoding","value":"gzip"},{"key":"Date","value":"Mon, 09 Jun 2025 10:00:38 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"user\": {\n \"companyName\": \"Example Subcontractor GmbH\",\n \"fieldOfActivityId\": \"60d21b4667d0d8992e610c85\",\n \"businessPhoneNumber\": \"+491751234567\",\n \"contactPersonFirstName\": \"John\",\n \"contactPersonLastName\": \"Doe\",\n \"address\": \"Some Street 123, 12345 Berlin, Germany\",\n \"isRegistrationComplete\": true,\n \"isRegistrationEmailSent\": false,\n \"email\": \"email@email.com\",\n \"role\": \"subcontractorCompany\",\n \"createdBy\": \"6846a870396cc290942aef75\",\n \"correspondenceLanguageCode\": \"en-UK\",\n \"constructionAreas\": [\n \"6846ae71396cc290942af0ce\"\n ],\n \"lockAccessAssignments\": [\n \"6846b076396cc290942af1a7\"\n ],\n \"subcontractorEmployees\": [],\n \"username\": \"username\",\n \"isEmailVerified\": true,\n \"isFirstTimeLogin\": false,\n \"userType\": \"SubcontractorCompany\",\n \"isActive\": false,\n \"additionalInformation\": \"This is a test subcontractor draft.\",\n \"RFIDmediums\": [],\n \"createdAt\": \"2025-06-09T09:49:06.673Z\",\n \"id\": \"6846ae12396cc290942af0a0\"\n },\n \"tokens\": {\n \"access\": {\n \"token\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiI2ODQ2YWUxMjM5NmNjMjkwOTQyYWYwYTAiLCJpYXQiOjE3NDk0NjMyMzgsImV4cCI6MTc1MDA2ODAzOCwidHlwZSI6ImFjY2VzcyJ9.Ha0Pm4mKMHzGP5d7OkH7kXwEGwsZ9_jxMknUMIiQd7I\",\n \"expires\": \"2025-06-16T10:00:38.924Z\"\n }\n }\n}"}],"_postman_id":"d2b2b031-9b21-4e76-b396-f729e01083f8"},{"name":"Logout","event":[{"listen":"test","script":{"id":"d18d378a-a62c-4d80-b073-bc03152cdf27","exec":[""],"type":"text/javascript","packages":{}}}],"id":"c5b61fb5-cc18-478e-9509-be632b11a5a9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"url":"http://localhost:4000/v1/auth/logout","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"bef9fc29-9217-46c1-9454-b79fc7f76a39","id":"bef9fc29-9217-46c1-9454-b79fc7f76a39","name":"EVVA Construction Area Project","type":"collection"}},"urlObject":{"path":["auth","logout"],"host":["http://localhost:4000/v1"],"query":[],"variable":[]}},"response":[],"_postman_id":"c5b61fb5-cc18-478e-9509-be632b11a5a9"},{"name":"Forgot Password","id":"b85aad43-39c5-4a4a-8f7a-6c7b2a3f6765","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"email\": \"test@test.com\"\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:4000/v1/auth/forgot-password","description":"

Forgot Password API

This endpoint is used to initiate the password recovery process for a user by sending a password reset link to the registered email address. After this endpoint, \"Reset Password\" endpoint should be used with the token and a new password.

Password rest token that can be received from the email after sending a request to forgot password endpoint

\n","type":"text/plain"},"key":"token","value":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VySWQiOiIxMjM0NTYiLCJpYXQiOjE3MTc3Mjk2MDAsIm5hbWUiOiJFcmluw6ciLCJyb2xlIjoiYWRtaW4ifQ.2ek6rPCnCg1MoUS9u9oz_SmT8gL7H0_LAA5FvKk_BtU"}],"variable":[]}},"response":[],"_postman_id":"982958df-1824-4cc2-b236-2af1f4636f3f"},{"name":"Change Password","id":"73a7741c-0b69-4c3b-8cc3-3bfa8a294cc2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"currentPassword\": \"Examplepassword1!\",\n \"newPassword\": \"Newpassword1!\"\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:4000/v1/auth/change-password","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"bef9fc29-9217-46c1-9454-b79fc7f76a39","id":"bef9fc29-9217-46c1-9454-b79fc7f76a39","name":"EVVA Construction Area Project","type":"collection"}},"urlObject":{"path":["auth","change-password"],"host":["http://localhost:4000/v1"],"query":[],"variable":[]}},"response":[],"_postman_id":"73a7741c-0b69-4c3b-8cc3-3bfa8a294cc2"},{"name":"Change Email","id":"653c6b94-7bd9-4bef-b922-8888444df415","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"password\": \"Examplepassword1!\",\n \"newEmail\": \"email@email.com\"\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:4000/v1/auth/change-email","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"bef9fc29-9217-46c1-9454-b79fc7f76a39","id":"bef9fc29-9217-46c1-9454-b79fc7f76a39","name":"EVVA Construction Area Project","type":"collection"}},"urlObject":{"path":["auth","change-email"],"host":["http://localhost:4000/v1"],"query":[],"variable":[]}},"response":[],"_postman_id":"653c6b94-7bd9-4bef-b922-8888444df415"},{"name":"Send Verification Email","id":"ce45cd6e-9e66-4764-a601-451b0f5aa96a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"email\": \"email@email.com\",\n \"password\": \"Examplepassword1!\"\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:4000/v1/auth/send-verification-email","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"bef9fc29-9217-46c1-9454-b79fc7f76a39","id":"bef9fc29-9217-46c1-9454-b79fc7f76a39","name":"EVVA Construction Area Project","type":"collection"}},"urlObject":{"path":["auth","send-verification-email"],"host":["http://localhost:4000/v1"],"query":[],"variable":[]}},"response":[],"_postman_id":"ce45cd6e-9e66-4764-a601-451b0f5aa96a"},{"name":"Verify Email","id":"f23ecebb-f78c-49f2-88d1-d1c90db122aa","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"url":"http://localhost:4000/v1/auth/verify-email?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VySWQiOiIxMjM0NTYiLCJpYXQiOjE3MTc3Mjk2MDAsIm5hbWUiOiJFcmluw6ciLCJyb2xlIjoiYWRtaW4ifQ.2ek6rPCnCg1MoUS9u9oz_SmT8gL7H0_LAA5FvKk_BtU","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"bef9fc29-9217-46c1-9454-b79fc7f76a39","id":"bef9fc29-9217-46c1-9454-b79fc7f76a39","name":"EVVA Construction Area Project","type":"collection"}},"urlObject":{"path":["auth","verify-email"],"host":["http://localhost:4000/v1"],"query":[{"description":{"content":"

Email verification token that can be received from the email that has been sent after registering

Authentication and authorization related routes

\n","_postman_id":"17f8e537-8e4a-4278-bfd3-9e7640ed9571","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"bef9fc29-9217-46c1-9454-b79fc7f76a39","id":"bef9fc29-9217-46c1-9454-b79fc7f76a39","name":"EVVA Construction Area Project","type":"collection"}}},{"name":"Account","item":[{"name":"Get Account","id":"ba9b0d66-9dcd-469f-99a7-dbfa905fb710","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://localhost:4000/v1/account","description":"

Response is different depending on the user role that has made the request. Different responses can be seen in the Example section

Account related routes

\n","_postman_id":"2fd132a9-9306-43c4-8276-1808c4001048","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"bef9fc29-9217-46c1-9454-b79fc7f76a39","id":"bef9fc29-9217-46c1-9454-b79fc7f76a39","name":"EVVA Construction Area Project","type":"collection"}}},{"name":"Construction Area","item":[{"name":"Get Construction Areas","id":"af784d15-54a8-4591-91a3-7fc3363c8fbb","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://localhost:4000/v1/construction-areas","description":"

Roles

constructionManager
\n
subcontractorCompany
\n
subcontractorEmployee
\n

Get by name

\n","type":"text/plain"},"key":"name","value":null},{"disabled":true,"description":{"content":"

Get by active status

\n","type":"text/plain"},"key":"isActive","value":null},{"disabled":true,"description":{"content":"

Get by address

\n","type":"text/plain"},"key":"address","value":null},{"disabled":true,"description":{"content":"

For pagination purposes

\n","type":"text/plain"},"key":"sortBy","value":null},{"disabled":true,"description":{"content":"

For pagination purposes

\n","type":"text/plain"},"key":"limit","value":null},{"disabled":true,"description":{"content":"

For pagination purposes

\n","type":"text/plain"},"key":"page","value":null}],"variable":[]}},"response":[{"id":"cea9ad7e-4bc2-446e-b381-36f3fd3b5543","name":"Get Construction Areas","originalRequest":{"method":"GET","header":[],"url":"http://localhost:4000/v1/construction-areas"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Security-Policy","value":"default-src 'self';base-uri 'self';block-all-mixed-content;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-Embedder-Policy","value":"require-corp"},{"key":"Cross-Origin-Opener-Policy","value":"same-origin"},{"key":"Cross-Origin-Resource-Policy","value":"same-origin"},{"key":"X-DNS-Prefetch-Control","value":"off"},{"key":"Expect-CT","value":"max-age=0"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"Strict-Transport-Security","value":"max-age=15552000; includeSubDomains"},{"key":"X-Download-Options","value":"noopen"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"Origin-Agent-Cluster","value":"?1"},{"key":"X-Permitted-Cross-Domain-Policies","value":"none"},{"key":"Referrer-Policy","value":"no-referrer"},{"key":"X-XSS-Protection","value":"0"},{"key":"Vary","value":"Origin, Accept-Encoding"},{"key":"Access-Control-Allow-Credentials","value":"true"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"495"},{"key":"ETag","value":"W/\"1ef-QpDplAJVB1SKmDyKiQK5D1jLm/k\""},{"key":"Date","value":"Mon, 09 Jun 2025 09:58:23 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"results\": [\n {\n \"name\": \"Area Name\",\n \"additionalInformation\": \"Additional information for the area\",\n \"isActive\": true,\n \"createdBy\": \"6846a870396cc290942aef75\",\n \"constructionManagers\": [\n \"6846af25396cc290942af117\"\n ],\n \"lockingComponents\": [\n \"6846ac70396cc290942aefdc\"\n ],\n \"subcontractorCompanies\": [\n \"6846ae12396cc290942af0a0\"\n ],\n \"address\": \"Address of the area\",\n \"extraResources\": [],\n \"createdAt\": \"2025-06-09T09:50:41.710Z\",\n \"id\": \"6846ae71396cc290942af0ce\"\n }\n ],\n \"page\": 1,\n \"limit\": 9007199254740991,\n \"totalPages\": 1,\n \"totalResults\": 1\n}"}],"_postman_id":"af784d15-54a8-4591-91a3-7fc3363c8fbb"},{"name":"Get Single Construction Area","id":"efdece10-2a71-451a-9546-88f9153d510e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://localhost:4000/v1/construction-areas/:id","description":"

Roles

constructionManager
\n
subcontractorCompany
\n
subcontractorEmployee
\n

Construction area id

\n","type":"text/plain"},"type":"any","value":"6345b3bd080d2a4ec38bef50","key":"id"}]}},"response":[{"id":"be867b99-92c9-4c45-86ae-fd57159cb095","name":"Single Construction Area Response","originalRequest":{"method":"GET","header":[],"url":{"raw":"http://localhost:4000/v1/construction-areas/:id","host":["http://localhost:4000/v1"],"path":["construction-areas",":id"],"variable":[{"key":"id","value":"6345b3bd080d2a4ec38bef50","description":"Construction area id"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Security-Policy","value":"default-src 'self';base-uri 'self';block-all-mixed-content;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-Embedder-Policy","value":"require-corp"},{"key":"Cross-Origin-Opener-Policy","value":"same-origin"},{"key":"Cross-Origin-Resource-Policy","value":"same-origin"},{"key":"X-DNS-Prefetch-Control","value":"off"},{"key":"Expect-CT","value":"max-age=0"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"Strict-Transport-Security","value":"max-age=15552000; includeSubDomains"},{"key":"X-Download-Options","value":"noopen"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"Origin-Agent-Cluster","value":"?1"},{"key":"X-Permitted-Cross-Domain-Policies","value":"none"},{"key":"Referrer-Policy","value":"no-referrer"},{"key":"X-XSS-Protection","value":"0"},{"key":"Vary","value":"Origin, Accept-Encoding"},{"key":"Access-Control-Allow-Credentials","value":"true"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"ETag","value":"W/\"5a8-41oyPRMMdaWHUSesZk/zV7i4X4Q\""},{"key":"Content-Encoding","value":"gzip"},{"key":"Date","value":"Sat, 07 Jun 2025 12:47:38 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"name\": \"Mock Area 12\",\n \"additionalInformation\": \"This is a mock construction area for testing purposes.\",\n \"isActive\": false,\n \"createdBy\": \"123e4567-e89b-12d3-a456-426614174000\",\n \"constructionManagers\": [\n \"abcdef12-3456-7890-abcd-ef1234567890\"\n ],\n \"lockingComponents\": [\n \"abcdef12-3456-7890-abcd-ef1234567891\"\n ],\n \"subcontractorCompanies\": [\n \"abcdef12-3456-7890-abcd-ef1234567892\"\n ],\n \"address\": \"123 Mockingbird Lane\",\n \"extraResources\": [\n {\n \"name\": \"Resource 1\",\n \"description\": \"Description of resource 1\",\n \"resourceURL\": \"https://example.com/resource1\",\n \"resourceType\": \"image\"\n },\n {\n \"name\": \"Resource 2\",\n \"description\": \"Description of resource 2\",\n \"resourceURL\": \"https://example.com/resource2\",\n \"resourceType\": \"video\"\n }\n ],\n \"createdAt\": \"2023-10-11T10:00:00.000Z\",\n \"id\": \"abcdef12-3456-7890-abcd-ef1234567893\"\n}\n"}],"_postman_id":"efdece10-2a71-451a-9546-88f9153d510e"},{"name":"Create Construction Area","id":"52acfa49-4c70-4bb5-aa4b-52c989d4e424","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"name\": \"Area Name\",\n \"additionalInformation\": \"Additional information for the area\",\n \"isActive\": true,\n \"address\": \"Address of the area\",\n \"floorPlanURL\": \"https://floorplan.com\"\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:4000/v1/construction-areas","description":"

\"Floor Plan\" is a url, to give the freedom of choosing data format to the client.

Roles

Superuser

This can be used to update a construction area. All attributes are optional. At least one of them should be included.

Roles

Superuser

id of the construction area

\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"88db8c37-6146-436b-b61a-fcacc29e8776"},{"name":"Delete Construction Area","id":"f27d6f5f-ddb7-422c-bcec-de837e6cca02","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[],"url":"http://localhost:4000/v1/construction-areas/:id","description":"

Roles

superuser

id of the construction area

\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"f27d6f5f-ddb7-422c-bcec-de837e6cca02"},{"name":"Assign Locks to a Construction Area","id":"a76c9869-8b1f-4d71-86ad-daedbc2de30a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"lockingComponentIdList\": [\n \"6400f1b7027c8fc64a828db4\",\n \"6400f1b7027c8fc64a828db5\",\n \"6400f1b7027c8fc64a828db6\"\n ]\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:4000/v1/construction-areas/:id/assign-locking-components","description":"

Without assigning locks, construction area will be empty and subcontractor companies won't be able to assigned to it.

Roles

superuser

id of the construction area

\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"a76c9869-8b1f-4d71-86ad-daedbc2de30a"},{"name":"Revoke Locks from a Construction Area","id":"e1e37909-6fdb-4402-9edb-eb5e0788c477","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"lockingComponentIdList\": [\n \"6400f1b7027c8fc64a828db4\",\n \"6400f1b7027c8fc64a828db5\",\n \"6400f1b7027c8fc64a828db6\"\n ]\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:4000/v1/construction-areas/:id/revoke-locking-components","description":"

Roles

superuser

id of the construction area

\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"e1e37909-6fdb-4402-9edb-eb5e0788c477"},{"name":"Assign Construction Managers to a Construction Area","id":"d1fa5d1e-d397-4c34-8757-9c965d860a85","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"constructionManagerIdList\": [\n \"6400f1b7027c8fc64a828db4\",\n \"6400f1b7027c8fc64a828db5\",\n \"6400f1b7027c8fc64a828db6\"\n ]\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:4000/v1/construction-areas/:id/assign-construction-managers","description":"

Roles

superuser

id of the construction area

\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"d1fa5d1e-d397-4c34-8757-9c965d860a85"},{"name":"Revoke Construction Managers from a Construction Area","id":"8b74ae7e-6a5a-4467-8bcf-a222266d1062","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"constructionManagerIdList\": [\n \"6400f1b7027c8fc64a828db4\",\n \"6400f1b7027c8fc64a828db5\",\n \"6400f1b7027c8fc64a828db6\"\n ]\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:4000/v1/construction-areas/:id/revoke-construction-managers","description":"

Roles

superuser

id of the construction area

\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"8b74ae7e-6a5a-4467-8bcf-a222266d1062"},{"name":"Assign Subcontractor Companies to a Construction Area","id":"efe1f37b-52b0-481d-beaa-70c5fc9e4ad6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"subcontractorCompanyIdList\": [\n \"6400f1b7027c8fc64a828db4\",\n \"6400f1b7027c8fc64a828db5\",\n \"6400f1b7027c8fc64a828db6\"\n ]\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:4000/v1/construction-areas/:id/assign-subcontractor-companies","description":"

Roles

constructionManager

id of the construction area

\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"efe1f37b-52b0-481d-beaa-70c5fc9e4ad6"},{"name":"Revoke Subcontractor Companies from a Construction Area","id":"3229bc24-dd62-41cc-a4af-36bb3ffdbf7a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"subcontractorCompanyIdList\": [\n \"6400f1b7027c8fc64a828db4\",\n \"6400f1b7027c8fc64a828db5\",\n \"6400f1b7027c8fc64a828db6\"\n ]\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:4000/v1/construction-areas/:id/revoke-subcontractor-companies","description":"

Roles

constructionManager

id of the construction area

\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"3229bc24-dd62-41cc-a4af-36bb3ffdbf7a"},{"name":"Get Locks of a Construction Area","id":"e1e76bf0-bb4f-4f24-8019-487e28a731c2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://localhost:4000/v1/construction-areas/:id/locking-components","description":"

Roles

constructionManager

id of the construction area

\n","type":"text/plain"},"type":"any","value":"6846ae71396cc290942af0ce","key":"id"}]}},"response":[{"id":"6de09a3f-81c8-4c46-b4a2-64fa726d8faa","name":"Get Locks of a Construction Area","originalRequest":{"method":"GET","header":[],"url":{"raw":"http://localhost:4000/v1/construction-areas/:id/locking-components","host":["http://localhost:4000/v1"],"path":["construction-areas",":id","locking-components"],"variable":[{"key":"id","value":"6846ae71396cc290942af0ce","description":"id of the construction area"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Security-Policy","value":"default-src 'self';base-uri 'self';block-all-mixed-content;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-Embedder-Policy","value":"require-corp"},{"key":"Cross-Origin-Opener-Policy","value":"same-origin"},{"key":"Cross-Origin-Resource-Policy","value":"same-origin"},{"key":"X-DNS-Prefetch-Control","value":"off"},{"key":"Expect-CT","value":"max-age=0"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"Strict-Transport-Security","value":"max-age=15552000; includeSubDomains"},{"key":"X-Download-Options","value":"noopen"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"Origin-Agent-Cluster","value":"?1"},{"key":"X-Permitted-Cross-Domain-Policies","value":"none"},{"key":"Referrer-Policy","value":"no-referrer"},{"key":"X-XSS-Protection","value":"0"},{"key":"Vary","value":"Origin, Accept-Encoding"},{"key":"Access-Control-Allow-Credentials","value":"true"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"381"},{"key":"ETag","value":"W/\"17d-nIKh4YFiqcTW5OF7JSxwtQGhMgg\""},{"key":"Date","value":"Mon, 09 Jun 2025 09:52:14 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"[\n {\n \"lockDoor\": {\n \"name\": null,\n \"additionalInformation\": \"Add. Information\",\n \"location\": \"Address of the area\"\n },\n \"evvaLockingComponentId\": 142590,\n \"isActive\": true,\n \"isInUse\": true,\n \"version\": 3,\n \"lockType\": \"CYLINDER\",\n \"lockIdentifier\": \"00053173FC1F1D11\",\n \"subcontractorCompanies\": [],\n \"createdAt\": \"2025-06-09T09:42:08.533Z\",\n \"constructionArea\": \"6846ae71396cc290942af0ce\",\n \"id\": \"6846ac70396cc290942aefdc\"\n }\n]"}],"_postman_id":"e1e76bf0-bb4f-4f24-8019-487e28a731c2"},{"name":"Add Extra Resource","id":"5c151aae-da3b-439c-bb91-9a0209bd11c7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"name\": \"Resource name\",\n \"resourceType\": \"image\",\n \"description\": \"Resource description\",\n \"resourceURL\": \"https://resource-url.com\"\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:4000/v1/construction-areas/:id/add-extra-resource","description":"

Extra resources can be added. Supports url

Roles

superuser

id of the construction area

\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"5c151aae-da3b-439c-bb91-9a0209bd11c7"},{"name":"Remove Extra Resource","id":"8668f107-6af4-46b0-a66d-f2b3202dbe84","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[],"body":{"mode":"raw","raw":"{\n \"name\": \"Resource name\",\n \"resourceType\": \"image\",\n \"description\": \"Resource description\",\n \"resourceURL\": \"https://resource-url.com\"\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:4000/v1/construction-areas/:id/remove-extra-resource/:extraResourceId","description":"

Roles

superuser

id of the construction area

\n","type":"text/plain"},"type":"any","value":"","key":"id"},{"description":{"content":"

id of the extra resource

\n","type":"text/plain"},"type":"any","value":"","key":"extraResourceId"}]}},"response":[],"_postman_id":"8668f107-6af4-46b0-a66d-f2b3202dbe84"}],"id":"b75114a1-8c9e-4861-92c1-26a037cd8942","description":"

Construction Areas help the client to group locks, construction managers and subcontractor companies. An area can be created and hold multiple locks, managers and companies.

\n","_postman_id":"b75114a1-8c9e-4861-92c1-26a037cd8942","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"bef9fc29-9217-46c1-9454-b79fc7f76a39","id":"bef9fc29-9217-46c1-9454-b79fc7f76a39","name":"EVVA Construction Area Project","type":"collection"}}},{"name":"Construction Manager","item":[{"name":"Get Construction Managers","id":"81d30712-286f-456c-b443-bb45e0acd66a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://localhost:4000/v1/construction-managers?email&username&firstName&lastName&isActive&correspondenceLanguageCode&sortBy&limit&page","description":"

Roles

superuser

Get by email

\n","type":"text/plain"},"key":"email","value":null},{"description":{"content":"

Get by username

\n","type":"text/plain"},"key":"username","value":null},{"description":{"content":"

Get by first name

\n","type":"text/plain"},"key":"firstName","value":null},{"description":{"content":"

Get by last name

\n","type":"text/plain"},"key":"lastName","value":null},{"description":{"content":"

Get by active status

\n","type":"text/plain"},"key":"isActive","value":null},{"description":{"content":"

Get by language

\n","type":"text/plain"},"key":"correspondenceLanguageCode","value":null},{"description":{"content":"

For pagination purposes

\n","type":"text/plain"},"key":"sortBy","value":null},{"description":{"content":"

For pagination purposes

\n","type":"text/plain"},"key":"limit","value":null},{"description":{"content":"

For pagination purposes

\n","type":"text/plain"},"key":"page","value":null}],"variable":[]}},"response":[{"id":"d0210376-7ef3-4a32-ac81-8f272d7f8f9f","name":"Get Construction Managers","originalRequest":{"method":"GET","header":[],"url":"http://localhost:4000/v1/construction-managers"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Security-Policy","value":"default-src 'self';base-uri 'self';block-all-mixed-content;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-Embedder-Policy","value":"require-corp"},{"key":"Cross-Origin-Opener-Policy","value":"same-origin"},{"key":"Cross-Origin-Resource-Policy","value":"same-origin"},{"key":"X-DNS-Prefetch-Control","value":"off"},{"key":"Expect-CT","value":"max-age=0"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"Strict-Transport-Security","value":"max-age=15552000; includeSubDomains"},{"key":"X-Download-Options","value":"noopen"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"Origin-Agent-Cluster","value":"?1"},{"key":"X-Permitted-Cross-Domain-Policies","value":"none"},{"key":"Referrer-Policy","value":"no-referrer"},{"key":"X-XSS-Protection","value":"0"},{"key":"Vary","value":"Origin, Accept-Encoding"},{"key":"Access-Control-Allow-Credentials","value":"true"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"800"},{"key":"ETag","value":"W/\"320-XGfq0c2if6trRPm8efDzVzsEkT0\""},{"key":"Date","value":"Mon, 09 Jun 2025 09:54:28 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"results\": [\n {\n \"firstName\": \"Name\",\n \"lastName\": \"LastName\",\n \"evvaPersonId\": 1269930,\n \"limits\": {\n \"phone\": 1,\n \"RFIDmedium\": 1,\n \"id\": \"6846af25396cc290942af116\"\n },\n \"phoneNumber\": \"+491111111111\",\n \"constructionAreas\": [\n \"6846ae71396cc290942af0ce\"\n ],\n \"email\": \"email@email.com\",\n \"username\": \"username1\",\n \"role\": \"constructionManager\",\n \"createdBy\": \"6846a870396cc290942aef75\",\n \"isEmailVerified\": true,\n \"isFirstTimeLogin\": true,\n \"correspondenceLanguageCode\": \"de-DE\",\n \"userType\": \"ConstructionManager\",\n \"isActive\": true,\n \"additionalInformation\": \"Additional information\",\n \"phones\": [],\n \"RFIDmediums\": [],\n \"lockAccessAssignmentsWithEvvaAuthorizationReflections\": [],\n \"favoriteLockingComponentsPerConstructionArea\": [],\n \"createdAt\": \"2025-06-09T09:53:41.357Z\",\n \"id\": \"6846af25396cc290942af117\"\n }\n ],\n \"page\": 1,\n \"limit\": 9007199254740991,\n \"totalPages\": 1,\n \"totalResults\": 1\n}"}],"_postman_id":"81d30712-286f-456c-b443-bb45e0acd66a"},{"name":"Create a Construction Manager","id":"fe03cdc7-b76a-4d7e-8fa2-e005746192c8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"email\": \"email@email.com\",\n \"password\": \"Examplepassword1!\",\n \"username\": \"username1\",\n \"firstName\": \"Name\",\n \"lastName\": \"LastName\",\n \"phoneNumber\": \"+491111111111\",\n \"correspondenceLanguageCode\": \"de-DE\",\n \"isActive\": true,\n \"additionalInformation\": \"Additional information\",\n \"isEmailVerified\": true,\n \"createEvvaPerson\": true\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:4000/v1/construction-managers","description":"

Roles

superuser

Roles

superuser

id of the construction manager

\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"152c60ce-1bf9-4de6-b686-faa6f2b49b4a"},{"name":"Delete a Construction Manager","id":"b170f5c8-04d2-4bf6-b4f8-bf93a6b959a2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[],"url":"http://localhost:4000/v1/construction-managers/:id","description":"

Roles

superuser

id of the construction manager

\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"b170f5c8-04d2-4bf6-b4f8-bf93a6b959a2"},{"name":"Get Single Construction Manager","id":"78bd704c-26bd-4914-a8e1-4c83ecd351bc","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://localhost:4000/v1/construction-managers/:id","description":"

Roles

superuser

id of the construction manager

\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"78bd704c-26bd-4914-a8e1-4c83ecd351bc"},{"name":"Create Favorite Locking Component","id":"b7f80a08-2705-4e4e-bbb0-c8098b5e8de5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"lockingComponentId\": \"64fa3b3a72e4ef1a1cfde903\",\n \"constructionAreaId\": \"64fa3b50d0ac5f6be5e1e3ff\"\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:4000/v1/construction-managers/:id/favorite-locking-components","description":"

Roles

constructionManager

id of the construction manager

\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"b7f80a08-2705-4e4e-bbb0-c8098b5e8de5"},{"name":"Get Favorite Locking Component","id":"97ff2462-8a77-4e59-bc71-d05d47e93f3a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://localhost:4000/v1/construction-managers/:id/favorite-locking-components?lockingComponentId&constructionAreaId","description":"

Roles

constructionManager

id of the locking component

\n","type":"text/plain"},"key":"lockingComponentId","value":null},{"description":{"content":"

id of the construction area

\n","type":"text/plain"},"key":"constructionAreaId","value":null}],"variable":[{"description":{"content":"

id of the construction manager

\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"97ff2462-8a77-4e59-bc71-d05d47e93f3a"},{"name":"Remove a Locking Component from Favorites","id":"c3b05ae3-e843-4cde-9fb9-a09c6012ba78","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[],"body":{"mode":"raw","raw":"{\n \"lockingComponentId\": \"64fa3b3a72e4ef1a1cfde903\",\n \"constructionAreaId\": \"64fa3b50d0ac5f6be5e1e3ff\"\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:4000/v1/construction-managers/:id/favorite-locking-components","description":"

Roles

constructionManager

id of the construction manager

\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"c3b05ae3-e843-4cde-9fb9-a09c6012ba78"}],"id":"7580269f-6fec-46bb-bf8b-1947838b9b33","description":"

Construction Manager is the role to manage a specific construction area. The role can see and approve a subcontractor company, assign them to proper date and lock.

\n","_postman_id":"7580269f-6fec-46bb-bf8b-1947838b9b33","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"bef9fc29-9217-46c1-9454-b79fc7f76a39","id":"bef9fc29-9217-46c1-9454-b79fc7f76a39","name":"EVVA Construction Area Project","type":"collection"}}},{"name":"Lock Access Assignment","item":[{"name":"Get Lock Access Assignments","id":"47826b90-c5e6-4a55-ab06-13e6d2d3d788","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://localhost:4000/v1/lock-access-assignments?id&lockingComponentId&subcontractorCompanyId&constructionAreaId&startDateTime&endDateTime&sortBy&limit&page&populate","description":"

Roles

constructionManager
\n
subcontractorCompany
\n
subcontractorEmployee
\n

Assignment id to get a specific one

\n","type":"text/plain"},"key":"id","value":null},{"description":{"content":"

To get assignments of a specific lock

\n","type":"text/plain"},"key":"lockingComponentId","value":null},{"description":{"content":"

To get assignments of a specific subcontractor company

\n","type":"text/plain"},"key":"subcontractorCompanyId","value":null},{"description":{"content":"

To get assignments of a specific construction area

\n","type":"text/plain"},"key":"constructionAreaId","value":null},{"description":{"content":"

To get assignments of a specific time period (ISO formatted, minutes can only be 0 or 30)

\n","type":"text/plain"},"key":"startDateTime","value":null},{"description":{"content":"

To get assignments of a specific time period (ISO formatted, minutes can only be 0 or 30)

\n","type":"text/plain"},"key":"endDateTime","value":null},{"description":{"content":"

For pagination purposes

\n","type":"text/plain"},"key":"sortBy","value":null},{"description":{"content":"

For pagination purposes

\n","type":"text/plain"},"key":"limit","value":null},{"description":{"content":"

For pagination purposes

\n","type":"text/plain"},"key":"page","value":null},{"description":{"content":"

Fields can be populated on demand

\n","type":"text/plain"},"key":"populate","value":null}],"variable":[]}},"response":[],"_postman_id":"47826b90-c5e6-4a55-ab06-13e6d2d3d788"},{"name":"Get Single Lock Access Assignment","id":"fd3fd8f2-27dd-41e4-b7a4-197302b71b92","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://localhost:4000/v1/lock-access-assignments/:lockAccessAssignmentId","description":"

Roles

constructionManager
\n
subcontractorCompany
\n
subcontractorEmployee
\n

Lock access assignment id

\n","type":"text/plain"},"type":"any","value":"","key":"lockAccessAssignmentId"}]}},"response":[],"_postman_id":"fd3fd8f2-27dd-41e4-b7a4-197302b71b92"},{"name":"Create Lock Access Assignment","id":"12a3e81a-5318-420e-a78e-fd6eb8cec829","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"assignmentList\": [\n {\n \"dateTimeList\": [\n {\n \"startDateTime\": \"2025-06-07T08:00:00Z\",\n \"endDateTime\": \"2025-06-07T10:30:00Z\"\n },\n {\n \"startDateTime\": \"2025-06-08T13:30:00Z\"\n }\n ],\n \"lockingComponentId\": \"64fa3b2f17d9c9e8a4b7d012\",\n \"subcontractorCompanyId\": \"64fa3b3a72e4ef1a1cfde903\",\n \"constructionAreaId\": \"64fa3b457e8b2acfa390f8a1\"\n },\n {\n \"dateTimeList\": [\n {\n \"startDateTime\": \"2025-06-09T09:00:00Z\",\n \"endDateTime\": \"2025-06-09T11:30:00Z\"\n }\n ],\n \"lockingComponentId\": \"64fa3b50d0ac5f6be5e1e3ff\",\n \"subcontractorCompanyId\": \"64fa3b5c13c2b9f4c89f7d4a\",\n \"constructionAreaId\": \"64fa3b6d92f3b9e5d12fca7b\"\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:4000/v1/lock-access-assignments","description":"

Roles

constructionManager

Roles

constructionManager

Roles

constructionManager

id of the lock access assignment to be deleted

\n","type":"text/plain"},"type":"any","value":"","key":"lockAccessAssignmentId"}]}},"response":[],"_postman_id":"53520c49-f71f-42a9-a0a3-798dec247af4"}],"id":"967865c4-5f70-48e0-829d-68b8a85f4e62","description":"

Routes to manage authorizations

\n","_postman_id":"967865c4-5f70-48e0-829d-68b8a85f4e62","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"bef9fc29-9217-46c1-9454-b79fc7f76a39","id":"bef9fc29-9217-46c1-9454-b79fc7f76a39","name":"EVVA Construction Area Project","type":"collection"}}},{"name":"Locking Component","item":[{"name":"Sync Locks With EVVA","id":"9c91b213-5a8b-4745-b293-954fab8463e3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://localhost:4000/v1/locking-components/sync-locks-with-evva","description":"

When a lock related operation had been made directly from the EVVA Airkey system, this endpoint must be called to synchronize the Construction Area system.

Roles

constructionManager
\n
subcontractorCompany
\n
subcontractorEmployee
\n

id of a specific locking component

\n","type":"text/plain"},"key":"id","value":null},{"description":{"content":"

EVVA id of a specific locking component

\n","type":"text/plain"},"key":"evvaLockingComponentId","value":null},{"description":{"content":"

To get all actively used or unused locks

\n","type":"text/plain"},"key":"isInUse","value":null},{"description":{"content":"

To get all locks of a specific construction area

\n","type":"text/plain"},"key":"constructionArea","value":null},{"description":{"content":"

For pagination purposes

\n","type":"text/plain"},"key":"sortBy","value":null},{"description":{"content":"

For pagination purposes

\n","type":"text/plain"},"key":"limit","value":null},{"description":{"content":"

For pagination purposes

\n","type":"text/plain"},"key":"page","value":null},{"description":{"content":"

To populate the fields on demand

\n","type":"text/plain"},"key":"populate","value":null}],"variable":[]}},"response":[],"_postman_id":"2b3f56bf-d506-4293-b891-db367fe24c97"},{"name":"Search a Lock by Door Properties","id":"1b09b979-fbf0-4051-8305-787f6a1f99cf","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"raw","raw":"{\n \"name\": \"Door Name\"\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:4000/v1/locking-components/lock-door-search","description":"

Door that a locking component has been attached to can be named with something different than the lock's name. Lock name can be kept same and door can differ.

Roles

constructionManager
\n
subcontractorCompany
\n
subcontractorEmployee
\n

Roles

constructionManager

id of the lock

\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"f8d7e901-30b1-4151-b3fb-400e51792303"}],"id":"447aa91e-e520-4122-8f93-83c546186fbf","description":"

Routes to manage locking components

\n","_postman_id":"447aa91e-e520-4122-8f93-83c546186fbf","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"bef9fc29-9217-46c1-9454-b79fc7f76a39","id":"bef9fc29-9217-46c1-9454-b79fc7f76a39","name":"EVVA Construction Area Project","type":"collection"}}},{"name":"Subcontractor Company","item":[{"name":"Create a Subcontractor Company Draft","id":"1b1dc4e1-9081-4431-9773-10c637941d48","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"email\": \"email@email.com\",\n \"companyName\": \"Example Subcontractor GmbH\",\n \"username\": \"exampleuser\",\n \"fieldOfActivityId\": \"60d21b4667d0d8992e610c85\",\n \"businessPhoneNumber\": \"+491751234567\",\n \"contactPersonFirstName\": \"John\",\n \"contactPersonLastName\": \"Doe\",\n \"address\": \"Some Street 123, 12345 Berlin, Germany\",\n \"correspondenceLanguageCode\": \"en-UK\",\n \"additionalInformation\": \"This is a test subcontractor draft.\",\n \"isEmailVerified\": false\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:4000/v1/subcontractor-companies","description":"

Roles

constructionManager

Roles

constructionManager

To get by a specific email

\n","type":"text/plain"},"key":"email","value":null},{"disabled":true,"description":{"content":"

To get by a specific username

\n","type":"text/plain"},"key":"username","value":null},{"disabled":true,"description":{"content":"

To get by a specific company name

\n","type":"text/plain"},"key":"companyName","value":null},{"disabled":true,"description":{"content":"

To get by a specific business phone number

\n","type":"text/plain"},"key":"businessPhoneNumber","value":null},{"disabled":true,"description":{"content":"

To get by activeness

\n","type":"text/plain"},"key":"isActive","value":null},{"disabled":true,"description":{"content":"

To get by the language code

\n","type":"text/plain"},"key":"correspondenceLanguageCode","value":null},{"disabled":true,"description":{"content":"

To get by a subcontractor company id

\n","type":"text/plain"},"key":"subcontractorCompany","value":null},{"disabled":true,"description":{"content":"

For pagination purposes

\n","type":"text/plain"},"key":"sortBy","value":null},{"disabled":true,"description":{"content":"

For pagination purposes

\n","type":"text/plain"},"key":"limit","value":null},{"disabled":true,"description":{"content":"

For pagination purposes

\n","type":"text/plain"},"key":"page","value":null}],"variable":[]}},"response":[{"id":"6bf40693-189e-44a7-9c82-550fa2a408b5","name":"Get Subcontractor Companies","originalRequest":{"method":"GET","header":[],"url":{"raw":"http://localhost:4000/v1/subcontractor-companies","host":["http://localhost:4000/v1"],"path":["subcontractor-companies"],"query":[{"key":"email","value":null,"description":"To get by a specific email","disabled":true},{"key":"username","value":null,"description":"To get by a specific username","disabled":true},{"key":"companyName","value":null,"description":"To get by a specific company name","disabled":true},{"key":"businessPhoneNumber","value":null,"description":"To get by a specific business phone number","disabled":true},{"key":"isActive","value":null,"description":"To get by activeness","disabled":true},{"key":"correspondenceLanguageCode","value":null,"description":"To get by the language code","disabled":true},{"key":"subcontractorCompany","value":null,"description":"To get by a subcontractor company id","disabled":true},{"key":"sortBy","value":null,"description":"For pagination purposes","disabled":true},{"key":"limit","value":null,"description":"For pagination purposes","disabled":true},{"key":"page","value":null,"description":"For pagination purposes","disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Security-Policy","value":"default-src 'self';base-uri 'self';block-all-mixed-content;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-Embedder-Policy","value":"require-corp"},{"key":"Cross-Origin-Opener-Policy","value":"same-origin"},{"key":"Cross-Origin-Resource-Policy","value":"same-origin"},{"key":"X-DNS-Prefetch-Control","value":"off"},{"key":"Expect-CT","value":"max-age=0"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"Strict-Transport-Security","value":"max-age=15552000; includeSubDomains"},{"key":"X-Download-Options","value":"noopen"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"Origin-Agent-Cluster","value":"?1"},{"key":"X-Permitted-Cross-Domain-Policies","value":"none"},{"key":"Referrer-Policy","value":"no-referrer"},{"key":"X-XSS-Protection","value":"0"},{"key":"Vary","value":"Origin, Accept-Encoding"},{"key":"Access-Control-Allow-Credentials","value":"true"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"833"},{"key":"ETag","value":"W/\"341-dlY++lIuBO3VJN3XtMe1R6X3atM\""},{"key":"Date","value":"Mon, 09 Jun 2025 09:44:58 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"results\": [\n {\n \"companyName\": \"Subcontractor Company\",\n \"fieldOfActivityId\": \"6846a870396cc290942aef6a\",\n \"businessPhoneNumber\": \"+49555555555\",\n \"contactPersonFirstName\": \"Name\",\n \"contactPersonLastName\": \"Lastname\",\n \"address\": \"Address\",\n \"isRegistrationComplete\": false,\n \"isRegistrationEmailSent\": false,\n \"email\": \"subcontractor1@email.com\",\n \"role\": \"subcontractorCompany\",\n \"createdBy\": \"6846a870396cc290942aef75\",\n \"correspondenceLanguageCode\": \"en-UK\",\n \"constructionAreas\": [],\n \"lockAccessAssignments\": [],\n \"subcontractorEmployees\": [],\n \"username\": \"subcontractorcompany\",\n \"isEmailVerified\": false,\n \"isFirstTimeLogin\": true,\n \"userType\": \"SubcontractorCompany\",\n \"isActive\": false,\n \"additionalInformation\": \"\",\n \"RFIDmediums\": [],\n \"createdAt\": \"2025-06-09T09:44:12.963Z\",\n \"id\": \"6846acec396cc290942af049\"\n }\n ],\n \"page\": 1,\n \"limit\": 9007199254740991,\n \"totalPages\": 1,\n \"totalResults\": 1\n}"}],"_postman_id":"ad7172f4-e339-4422-b233-5b846b4cbe09"},{"name":"Get Single Subcontractor Company","id":"cd2ac4ee-da13-4336-adde-6e10188f0529","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://localhost:4000/v1/subcontractor-companies/:id","description":"

Roles

constructionManager

id of the subcontractor company to be fetched

\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"cd2ac4ee-da13-4336-adde-6e10188f0529"},{"name":"Update Subcontractor Company","id":"6418e022-a3fb-4757-bd9e-1c3b91093550","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[],"body":{"mode":"raw","raw":"{\n \"username\": \"updatedusername\",\n \"email\": \"updatedcompany@example.com\",\n \"companyName\": \"Updated Company Name\",\n \"fieldOfActivityId\": \"60c72b2f9b1d8e6f88e0b123\",\n \"businessPhoneNumber\": \"+4917612345678\",\n \"contactPersonFirstName\": \"UpdatedFirst\",\n \"contactPersonLastName\": \"UpdatedLast\",\n \"address\": \"Updated Address, Berlin\",\n \"correspondenceLanguageCode\": \"en-UK\",\n \"additionalInformation\": \"Some notes about the update\"\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:4000/v1/subcontractor-companies/:id","description":"

Roles

constructionManager

id of the subcontractor company to be updated

\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"6418e022-a3fb-4757-bd9e-1c3b91093550"},{"name":"Delete Subcontractor Company","id":"48499d42-ead5-4daf-ab76-3be8b2ac1c7f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[],"url":"http://localhost:4000/v1/subcontractor-companies/:id","description":"

Roles

constructionManager

id of the subcontractor company to be deleted

\n","type":"text/plain"},"type":"any","value":"6846ad9d396cc290942af07e","key":"id"}]}},"response":[],"_postman_id":"48499d42-ead5-4daf-ab76-3be8b2ac1c7f"},{"name":"Complete Subcontractor Company Draft","id":"241880e1-d2ac-4aa9-aedc-f11aed17b922","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"url":"http://localhost:4000/v1/subcontractor-companies/:id/complete","description":"

Roles

constructionManager

id of the subcontractor company to be completed

\n","type":"text/plain"},"type":"any","value":"6846ad9d396cc290942af07e","key":"id"}]}},"response":[],"_postman_id":"241880e1-d2ac-4aa9-aedc-f11aed17b922"},{"name":"Register Subcontractor Company","id":"6b624a71-e747-4aac-a7e5-cd4a6de4d1f6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"username\": \"username\",\n \"email\": \"email@email.com\",\n \"password\": \"Examplepassword1!\"\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:4000/v1/subcontractor-companies/:id/register","description":"

This endpoint can be used to set username, email and password for a subcontractor company draft. Username and email should be unique. Draft should have already existed in the system. A registration email will be send after a successful operation.

id of the subcontractor company to be registered

\n","type":"text/plain"},"type":"any","value":"6846ae12396cc290942af0a0","key":"id"}]}},"response":[],"_postman_id":"6b624a71-e747-4aac-a7e5-cd4a6de4d1f6"}],"id":"a5f546b4-b02b-49fa-a71a-2c09cdf80286","description":"

Subcontractor companies are the companies that work on the construction site. They can have employees, own accounts, and types (cleaning, piping, painting, etc.)

A subcontractor company can be added by the superuser or a construction manager role. It's created in a draft state by default. After assigning a company to a specific construction area, a construction manager can retrieve the company list and approve the companies.

\n","_postman_id":"a5f546b4-b02b-49fa-a71a-2c09cdf80286","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"bef9fc29-9217-46c1-9454-b79fc7f76a39","id":"bef9fc29-9217-46c1-9454-b79fc7f76a39","name":"EVVA Construction Area Project","type":"collection"}}},{"name":"Subcontractor Employee","item":[{"name":"Create Subcontractor Employee","id":"ef668d68-2413-4ea8-a0f5-eadd6351c40b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"email\": \"worker@example.com\",\n \"password\": \"StrongPassw0rd!\",\n \"username\": \"subcontractorWorker1\",\n \"firstName\": \"John\",\n \"lastName\": \"Doe\",\n \"phoneNumber\": \"+905551112233\",\n \"correspondenceLanguageCode\": \"en-UK\",\n \"isActive\": true,\n \"additionalInformation\": \"Temporary employee\",\n \"isEmailVerified\": false,\n \"subcontractorCompany\": \"6846ae12396cc290942af0a0\"\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:4000/v1/subcontractor-employees","description":"

Roles

subcontractorCompany

Roles

subcontractorCompany

Search employees by email

\n","type":"text/plain"},"key":"email","value":""},{"disabled":true,"description":{"content":"

Search employees by username

\n","type":"text/plain"},"key":"username","value":""},{"disabled":true,"description":{"content":"

Search employees by first name

\n","type":"text/plain"},"key":"firstName","value":""},{"disabled":true,"description":{"content":"

Search employees by last name

\n","type":"text/plain"},"key":"lastName","value":""},{"disabled":true,"description":{"content":"

Search employees by activeness

\n","type":"text/plain"},"key":"isActive","value":""},{"disabled":true,"description":{"content":"

Search employees by language code

\n","type":"text/plain"},"key":"correspondenceLanguageCode","value":""},{"disabled":true,"description":{"content":"

Search employees by subcontractor company id

\n","type":"text/plain"},"key":"subcontractorCompany","value":""},{"disabled":true,"description":{"content":"

For pagination purposes

\n","type":"text/plain"},"key":"sortBy","value":""},{"disabled":true,"description":{"content":"

For pagination purposes

\n","type":"text/plain"},"key":"limit","value":""},{"disabled":true,"description":{"content":"

For pagination purposes

\n","type":"text/plain"},"key":"page","value":""},{"disabled":true,"description":{"content":"

Populate areas on demand

\n","type":"text/plain"},"key":"populate","value":null}],"variable":[]}},"response":[{"id":"d4e294a9-3823-465e-8165-5dbf07aeb256","name":"Create Subcontractor Employee Copy","originalRequest":{"method":"GET","header":[],"url":{"raw":"http://localhost:4000/v1/subcontractor-employees","host":["http://localhost:4000/v1"],"path":["subcontractor-employees"],"query":[{"key":"email","value":"","description":"Search employees by email","disabled":true},{"key":"username","value":"","description":"Search employees by username","disabled":true},{"key":"firstName","value":"","description":"Search employees by first name","disabled":true},{"key":"lastName","value":"","description":"Search employees by last name","disabled":true},{"key":"isActive","value":"","description":"Search employees by activeness","disabled":true},{"key":"correspondenceLanguageCode","value":"","description":"Search employees by language code","disabled":true},{"key":"subcontractorCompany","value":"","description":"Search employees by subcontractor company id","disabled":true},{"key":"sortBy","value":"","description":"For pagination purposes","disabled":true},{"key":"limit","value":"","description":"For pagination purposes","disabled":true},{"key":"page","value":"","description":"For pagination purposes","disabled":true},{"key":"populate","value":null,"description":"Populate areas on demand","disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Security-Policy","value":"default-src 'self';base-uri 'self';block-all-mixed-content;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-Embedder-Policy","value":"require-corp"},{"key":"Cross-Origin-Opener-Policy","value":"same-origin"},{"key":"Cross-Origin-Resource-Policy","value":"same-origin"},{"key":"X-DNS-Prefetch-Control","value":"off"},{"key":"Expect-CT","value":"max-age=0"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"Strict-Transport-Security","value":"max-age=15552000; includeSubDomains"},{"key":"X-Download-Options","value":"noopen"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"Origin-Agent-Cluster","value":"?1"},{"key":"X-Permitted-Cross-Domain-Policies","value":"none"},{"key":"Referrer-Policy","value":"no-referrer"},{"key":"X-XSS-Protection","value":"0"},{"key":"Vary","value":"Origin, Accept-Encoding"},{"key":"Access-Control-Allow-Credentials","value":"true"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"805"},{"key":"ETag","value":"W/\"325-BpcMpotBPlll2vFPl5sZRe4j/C0\""},{"key":"Date","value":"Mon, 09 Jun 2025 10:05:50 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"results\": [\n {\n \"firstName\": \"John\",\n \"lastName\": \"Doe\",\n \"evvaPersonId\": 1269932,\n \"limits\": {\n \"phone\": 1,\n \"RFIDmedium\": 1,\n \"id\": \"6846b1f2396cc290942af1fe\"\n },\n \"subcontractorCompany\": \"6846ae12396cc290942af0a0\",\n \"email\": \"worker@example.com\",\n \"username\": \"subcontractorWorker1\",\n \"password\": \"$2a$10$K3hObWmE1N/q.uulqRA/xu0f87NcICKrcD2b6YbbvuqbLnblsel/.\",\n \"role\": \"subcontractorEmployee\",\n \"createdBy\": \"6846ae12396cc290942af0a0\",\n \"isEmailVerified\": false,\n \"isFirstTimeLogin\": true,\n \"correspondenceLanguageCode\": \"en-UK\",\n \"userType\": \"SubcontractorEmployee\",\n \"isActive\": true,\n \"additionalInformation\": \"Temporary employee\",\n \"phones\": [],\n \"RFIDmediums\": [],\n \"lockAccessAssignmentsWithEvvaAuthorizationReflections\": [],\n \"createdAt\": \"2025-06-09T10:05:38.867Z\",\n \"id\": \"6846b1f2396cc290942af1ff\"\n }\n ],\n \"page\": 1,\n \"limit\": 9007199254740991,\n \"totalPages\": 1,\n \"totalResults\": 1\n}"}],"_postman_id":"9c6225d2-9e4f-4d79-9146-ad997230f5b7"},{"name":"Get a Single Subcontractor Employee","id":"ddc1450d-f06b-4fc1-be1e-4f0d0019c3a8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://localhost:4000/v1/subcontractor-employees/:id","description":"

Roles

subcontractorCompany

id of the employee to get

\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"ddc1450d-f06b-4fc1-be1e-4f0d0019c3a8"},{"name":"Update a Single Subcontractor Employee","id":"b3e2976b-f3d9-47cc-81e2-22ad0d4debfe","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[],"body":{"mode":"raw","raw":"{\n \"email\": \"updated.worker@example.com\",\n \"password\": \"NewStr0ngPass!\",\n \"username\": \"updatedWorker\",\n \"firstName\": \"Johnn\",\n \"lastName\": \"Doee\",\n \"correspondenceLanguageCode\": \"en-UK\",\n \"isActive\": false,\n \"additionalInformation\": \"Only works in the office.\",\n \"constructionProjects\": [\n \"665f1a0d5b8b3e6cd1a0f110\",\n \"665f1a0d5b8b3e6cd1a0f111\"\n ],\n \"lockingComponents\": [\n \"665f1a0d5b8b3e6cd1a0f112\"\n ]\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:4000/v1/subcontractor-employees/:id","description":"

Roles

subcontractorCompany

id of the employee to update

\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"b3e2976b-f3d9-47cc-81e2-22ad0d4debfe"},{"name":"Delete a Single Subcontractor Employee","id":"f72b94c5-6d5e-4aaa-babd-0741087edb3f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[],"url":"http://localhost:4000/v1/subcontractor-employees/:id","description":"

Roles

subcontractorCompany

id of the employee to delete

\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"f72b94c5-6d5e-4aaa-babd-0741087edb3f"}],"id":"daadbd88-e41f-4395-a150-60f8c2b53570","description":"

Endpoints to manage employees of a subcontractor company

\n","_postman_id":"daadbd88-e41f-4395-a150-60f8c2b53570","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"bef9fc29-9217-46c1-9454-b79fc7f76a39","id":"bef9fc29-9217-46c1-9454-b79fc7f76a39","name":"EVVA Construction Area Project","type":"collection"}}},{"name":"System Config","item":[{"name":"Create Subcontractor Type","id":"9bf29570-48b1-4cb2-a6ec-119b0ca42048","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"code\": \"1.1\",\n \"name\": \"Cleaning\",\n \"colorCode\": \"#000\"\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:4000/v1/system-config/subcontractor-types","description":"

Roles

superuser

Roles

constructionManager
\n
subcontractorCompany
\n
subcontractorEmployee
\n

Roles

superuser

id of the subcontractor type to be deleted

\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"0201d681-0a32-4cb5-8550-5fcf441927b2"},{"name":"Update a Subcontractor Type","id":"4bcc741a-afa7-46ee-affe-e8bc4a6d9206","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[],"body":{"mode":"raw","raw":"{\n \"code\": \"1.2\",\n \"name\": \"Painter\",\n \"colorCode\": \"#FF5733\"\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:4000/v1/system-config/subcontractor-types/:id","description":"

Roles

superuser

id of the subcontractor type to be updated

\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"4bcc741a-afa7-46ee-affe-e8bc4a6d9206"},{"name":"Get a Single Subcontractor Type","id":"dfd95560-058e-438e-a05e-f1428ca56c26","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://localhost:4000/v1/system-config/subcontractor-types/:id","description":"

Roles

constructionManager
\n
subcontractorCompany
\n
subcontractorEmployee
\n

id of the subcontractor type to be fetched

\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"dfd95560-058e-438e-a05e-f1428ca56c26"}],"id":"45f21f21-6f39-4e4e-bbac-17acdc181528","description":"

Endpoints related to a system-wide configs, specifically subcontractor types

\n","_postman_id":"45f21f21-6f39-4e4e-bbac-17acdc181528","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"bef9fc29-9217-46c1-9454-b79fc7f76a39","id":"bef9fc29-9217-46c1-9454-b79fc7f76a39","name":"EVVA Construction Area Project","type":"collection"}}},{"name":"Unlocking Component","item":[{"name":"Get Cards","id":"4fe86df1-4ad4-48d2-acf0-bd37f86a06f7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://localhost:4000/v1/unlocking-components/cards","description":"

Roles

constructionManager

When a card/chip related operation had been made directly from the EVVA Airkey system, this endpoint must be called to synchronize the Construction Area system.

Card id to cancel assignment

\n","type":"text/plain"},"type":"any","value":"","key":"cardId"}]}},"response":[],"_postman_id":"df2886e3-348d-4154-a3f3-c78c507e8ca1"},{"name":"Give Owner to Cards","id":"f123eaaa-6109-4315-9fa2-1818388cddcc","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"ownershipList\": [\n {\n \"cardId\": \"665f1a0d5b8b3e6cd1a0f101\",\n \"ownerId\": \"665f1a0d5b8b3e6cd1a0f102\"\n },\n {\n \"cardId\": \"665f1a0d5b8b3e6cd1a0f103\",\n \"ownerId\": \"665f1a0d5b8b3e6cd1a0f104\"\n }\n ],\n \"ownerType\": \"company\"\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:4000/v1/unlocking-components/cards/owner","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"bef9fc29-9217-46c1-9454-b79fc7f76a39","id":"bef9fc29-9217-46c1-9454-b79fc7f76a39","name":"EVVA Construction Area Project","type":"collection"}},"urlObject":{"path":["unlocking-components","cards","owner"],"host":["http://localhost:4000/v1"],"query":[],"variable":[]}},"response":[],"_postman_id":"f123eaaa-6109-4315-9fa2-1818388cddcc"},{"name":"Revoke Owner from a Card","id":"930bf8e3-da94-421c-af77-83b3505e69a8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[],"url":"http://localhost:4000/v1/unlocking-components/cards/owner/:cardId","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"bef9fc29-9217-46c1-9454-b79fc7f76a39","id":"bef9fc29-9217-46c1-9454-b79fc7f76a39","name":"EVVA Construction Area Project","type":"collection"}},"urlObject":{"path":["unlocking-components","cards","owner",":cardId"],"host":["http://localhost:4000/v1"],"query":[],"variable":[{"description":{"content":"

Card id to revoke ownership

\n","type":"text/plain"},"type":"any","value":"","key":"cardId"}]}},"response":[],"_postman_id":"930bf8e3-da94-421c-af77-83b3505e69a8"},{"name":"Create, Assign, Pair Phone","id":"ca99dfaa-8c7f-4cdc-89a2-0810ba93e52e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"phoneNumber\": \"+491111111111\",\n \"evvaPersonId\": 12324\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:4000/v1/unlocking-components/phones/create-assign-pair-phone","description":"

This endpoint creates a new phone in the EVVA Airkey system, if it's not already existing. Then the phone gets assigned to the given EVVA person. After the pairing is a success, an SMS code is sent by EVVA to the phone number. When the instructions in the SMS followed, authorizations can be created.

Endpoints to manage unlocking components, cards (chips) and phones.

Card ownership and card assignment are two distinct operations.

Card ownership is a soft operation managed only at the database level. It indicates who currently possesses or uses the card. For example, a subcontractor company may hand a card (chip) over to one of its employees, making that employee the current owner of the card.

However, the assignment of the card remains with the subcontractor company. This means that in the EVVA AirKey dashboard, the card will still appear as assigned to the subcontractor company, regardless of who the current owner is.

\n","_postman_id":"39f483f5-f50d-4633-80d5-94c156595072","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"bef9fc29-9217-46c1-9454-b79fc7f76a39","id":"bef9fc29-9217-46c1-9454-b79fc7f76a39","name":"EVVA Construction Area Project","type":"collection"}}}],"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]}},"event":[{"listen":"prerequest","script":{"id":"ed333b1a-6829-42fd-90dd-d298f974a11f","type":"text/javascript","packages":{},"exec":[""]}},{"listen":"test","script":{"id":"df8a713a-c0bb-460c-9f47-cbc5b5998746","type":"text/javascript","packages":{},"exec":[""]}}],"variable":[{"key":"API_URL","value":"http://localhost:4000/v1","type":"string"},{"key":"TOKEN","value":"","type":"string"}]}