GET
/
users
/
List users
curl --request GET \
  --url http:localhost:3000/v2/users/ \
  --header 'x-API-Key: <api-key>'
[
  {
    "_id": "<string>",
    "number": 123,
    "companyId": "<string>",
    "status": {
      "status": 123,
      "createdAt": "2023-11-07T05:31:56Z",
      "createdBy": "<string>",
      "lastModifiedAt": "2023-11-07T05:31:56Z",
      "lastModifiedBy": "<string>"
    },
    "chatId": "<string>",
    "id": "36920",
    "general": {
      "firstName": "John",
      "lastName": "Doe",
      "sex": "male",
      "birthDate": "15.08.1990",
      "language": "de",
      "insuranceNumber": "12345678901",
      "deviceToken": "dGhpcyBpcyBhIHRva2VuIGV4YW1wbGU=",
      "webPushToken": "BKP4z...",
      "profileImage": "https://example.com/profiles/user123.jpg",
      "description": "Team lead with 5 years experience",
      "lastNpsScoreSend": "2023-11-07T05:31:56Z",
      "badges": [
        {
          "type": "experience",
          "level": "senior"
        }
      ]
    },
    "access": {
      "dashboardAccess": true,
      "webAccess": "1",
      "token": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "email": "user@company.com",
      "loginTries": 0,
      "passwordChangeToken": "reset-token-12345",
      "passwordChangeDate": "2023-12-01T10:30:00Z"
    },
    "contract": {
      "startDate": "2023-01-01T00:00:00Z",
      "endDate": "2024-12-31T23:59:59Z",
      "department": "service",
      "salary": 15.5,
      "salaryType": "hourly",
      "employment": "full-time",
      "payment": "direct-deposit",
      "dailyWorkingHours": {},
      "payTypeId": "<string>",
      "vacationDays": 30,
      "remainingLeave": [
        {
          "year": 2023,
          "days": 5
        }
      ],
      "allowedToTrackDrivingTime": true
    },
    "contact": {
      "telephone": "+1-555-123-4567",
      "mobile": "+1-555-987-6543",
      "email": "contact@company.com",
      "sms": "+1-555-111-2222",
      "smsCount": 5,
      "smsChatCount": 12,
      "smsSendDate": "2024-01-15T10:30:00Z",
      "smsSendBy": "user123",
      "website": "https://www.company.com",
      "lastSMSStatus": "delivered",
      "secondSmsSendDate": "2024-01-16T14:45:00Z"
    },
    "address": {
      "street": "<string>",
      "zip": "<string>",
      "city": "<string>",
      "country": "<string>",
      "co": "<string>",
      "state": "<string>"
    },
    "accessGroupId": "service",
    "totalTargetHours": 40,
    "jobs": [
      {}
    ],
    "setUpDone": true,
    "location": {
      "latitude": 48.8566,
      "longitude": 2.3522,
      "location": {
        "type": "Point",
        "coordinates": [
          2.3522,
          48.8566
        ]
      }
    },
    "activityTypeIds": [
      "cleaning",
      "maintenance",
      "inspection"
    ],
    "implementation": {
      "hasJob": true,
      "hasTimeTracking": true,
      "isSuccessfullyImplemented": false,
      "lastTimeActive": "2023-12-01T14:30:00Z"
    },
    "workedOnObjectIds": [
      "507f1f77bcf86cd799439011",
      "507f191e810c19729de860ea"
    ],
    "tags": [
      "full-time",
      "certified",
      "team-lead"
    ],
    "analytics": {
      "createdProfile": "2023-01-15T09:00:00Z"
    }
  }
]

Authorizations

​
x-API-Key
string
header
required

Query Parameters

​
limit
integer
default:100

Maximum number of users to return

Required range: 1 <= x <= 1000
​
offset
integer
default:0

Number of users to skip for pagination

Required range: x >= 0
​
sort
string

Sort order (e.g., name:1, status.createdAt:-1)

​
name
string

Filter by name (partial match, supports full name or number)

​
username
string

Filter by user name (full name or number)

​
status
string

Filter by status (single value or comma-separated list)

​
employment

Filter by employment type (can be a single value or array)

​
ids
string<objectid>[]

Filter by IDs (array of objectIds)

​
excludeIds
string<objectId>[]

Filter to exclude specific IDs from search results

​
tags
string[]

Filter by tags

​
activityTypeId
string<objectId>[]

Filter to search jobs by activity type IDs. It can handle multiple activity type IDs and also includes checks for assignments, jobs, and salaries.

Activity Type ID to filter by

​
workedOnObjects
string<objectid>[]

Filter by worked on object IDs

​
worksOnObject
string<objectId>[]

Filter users based on the objects they work on

​
currentlyWorking
boolean

Filter to search for users who are currently working on active jobs.

​
basedOnObjectManager
string<objectId>[]

Filter users based on the object managers they have access to

Response

200
application/json

List of users

The response is of type User · object[].