User API Filters

Filter parameters to help you filter the user data retrieved via our User API.

Filter parameters for /api/users GET endpoint

The GET endpoint /api/users to retrieve users provides a filter parameter that supports filtering using the SCIM notation.

PropertyFilter operatorAllowed values
groupsis member (eq)
not member (ne)
{groupID}
staffbase.creationTypeequal to (eq)
  • csv
  • direct
  • scim
  • sso
staffbase.role
User Role Type
equal to (eq)
  • admin
  • editor
  • moderator
  • managingEditor
  • reader
staffbase.spaceis member (eq){spaceID}
staffbase.statusequal to (eq)
  • activated (default)
  • deactivated
  • pending
created
The point in time when the user was created in the platform.
gt, ge, le, lt, eq, neThe value for the point in time is dynamic. Examples:
  • 2022-05-30
  • 2022-05-30T10:00
  • 2022-05-30T10:00:00.000Z
updated
The point in time when the user was last updated.
gt, ge, le, lt, eq, neThe value for the point in time is dynamic. Examples:
  • 2021-07-07
  • 2021-07-07T10:00
  • 2021-07-07T10:00:00.000Z
deactivated
The point in time when the user was deactivated in the platform.
gt, ge, le, lt, eq, neThe value for the point in time is dynamic. Examples:
  • 2022-05-30
  • 2022-05-30T10:00
  • 2022-05-30T10:00:00.000Z
User typepresent (pr)
  • emails
  • externalId
  • password
  • staffbase.recoveryCode
  • userName

Examples

1// Only members of the given group ID
2groups eq "604fab5e830203614e6fa59d"
3
4// Only members part of the given space ID
5staffbase.space eq "5fc7743d3dd910548d350a2a"
6
7// Only registered admin users
8staffbase.status eq "activated" and staffbase.role eq "admin"
9
10// Only users created via CSV import or SSO
11staffbase.creationType eq "csv" or staffbase.creationType eq "sso"
12
13// Custom profile fields (use the profile field ID for data import)
14profile.{fieldID} eq "value"
15
16// -------------------- //
17// Different User Types //
18// -------------------- //
19
20// Only users with primary email or username and Staffbase password
21(emails pr or userName pr) and password pr
22
23// Only access code users (no primary email and username)
24(not (emails pr) and not (userName pr) and password pr)
25
26// Only SSO users (identifier, but no Staffbase password)
27(externalId pr and not (password pr))
28
29// ---------------------- //
30// Filter for Date & Time //
31// ---------------------- //
32
33// All users that were created since day = 2021-01-01, time = 10:00
34created gt "2021-01-01T10:00"
35
36// All users that were created before day = 2022-01-01
37created lt "2022-01-01"
38
39// All users that were updated since day = 2021-07-07, time = 10:00
40updated gt "2021-07-07T10:00"
41
42// All users that were updated before day = 2021-05-24
43updated lt "2021-05-24"
44
45// All users that were deactivated since day = 2021-07-07, time = 10:00
46deactivated gt "2021-07-07T10:00"
47
48// All users that were deactivated before day = 2021-05-24
49deactivated lt "2021-05-24"

Since filter is a URL parameter, whitespaces (space = %20) and quotes (" = %22) have to be URL encoded.

Example: only access code users, so no existing primary email and username

https://exampleapp.staffbase.com/api/users?filter=(not%20(emails%20pr)%20and%20not%20(userName%20pr)%20and%20password%20pr)

Additional helpful information