Users

Fetch users

Changed on
get/users

Request

  • Base URL
    https://api.kisi.io
  • URL
    https://api.kisi.io/users
  • Auth
    • API key in header Authorization
    • or OAuth 2
      Authorization code: https://api.kisi.io/oauth/authorize
      Token URL: https://api.kisi.io/oauth/token

Query parameters

idsstring

Filter by object IDs

place_idinteger

Filters users that have access to given place.

emailstring

Filter by email.

place_idinteger

Filters users that have access to given place.

group_idinteger

Filter by group ID

querystring

Filter by a freetext string. Properties searched: email, name, notes

integer
OR
string

Filter by user ID or by current user if value is me.

sort'name' | '-name' | 'unlock' | '-unlock' | 'access_enabled' | '-access_enabled'

Sort the results. Prepend - to sort in reverse order.

name - sort by user name, alphabetically<br> unlock - sort by last unlock; no unlocks first, then oldest to most recent

limitinteger

The number of objects to return

offsetinteger

The number of objects to offset

Response

OK

idinteger required

The ID of the user

resource_type'User' required

The resource type of the user

namestring required

The name of the user

emailstring email required

The email of the user.

created_atstring date-time required

When the user was created

updated_atstring date-time required

When the user was updated

metadataobject required

The metadata for the user.

  • Only basic types are allowed: string, null, integer, float, boolean.
  • Keys have a limit of 50 characters.
  • Values have a limit of 500 characters.
  • Keys number is limited to 50.
imagestring uri nullable required

The url to the image of the user.

otp_required_for_loginboolean required

Whether OTP/2FA is required for login.

password_flow_enabledboolean required

Whether the user can login with password flow. Only relevant for organizations.

access_enabledboolean required

Whether the user is allowed to access locks and elevators.

If the user is managed by SCIM, user access will be disabled unless both the access_enabled field and scim_access_enabled fields are set to true.

last_accessed_atstring date-time nullable required

When the user last accessed a door.

scim_access_enabledboolean required

Whether the user is allowed to access locks and elevators.

This field is read-only and can only be managed using SCIM. (See access_enabled)

It will always be set to true if the user is not managed by SCIM.

notesstring nullable required

The notes for the user.

organization_idinteger required

The organization ID of the user

confirmedboolean required
groups_countinteger required

Changes

  • 892ee0d3a464Revision changes
    • warning

      deleted the query request parameter place_id

    • info

      added the new optional query request parameter place_id

  • aba4967166f2Revision changes
    • warning

      deleted the query request parameter place_id

    • info

      added the new optional query request parameter place_id