List All Users

Scopes
read:user

Query Parameters

limit
integer
min-1
max
500

Limit the number of results returned

offset
integer
min0
max
99999999999999

Page number of records you wish to skip before selecting records. Final skipped records count would be limit * offset.

q
string

Additional query in PlusAuth Query Language format.

sort_by
string

Properties that should be ordered by with their order type. To define order append it to the field with dot. For example: sort_by=email.asc or sort_by=email.desc

GET
/users
1
2
3
Loading...
Response:
200
Loading...

Response Body Schema

results
array<object>
results.
credentials
array<object>
Zorunlu
results.
id
string
Zorunlu
results.
last_ip
string
Zorunlu
results.
blocked
boolean

Whether this End-User is blocked or not. If true End-User will not be able to login.

results.
email
string

End-User's e-mail address.

results.
email_verified
boolean

true if the End-User's e-mail address has been verified; otherwise false. If force_email_verification is enabled in your tenant's settings, it will check this value of user while performing email verification checks.

results.
identities
array<object>
results.identities.
connection
string
Zorunlu

Connection name

results.identities.
id
string
Zorunlu

External user's id coming from the connection.

results.identities.
provider
string
Zorunlu

Mevcut Değerler: twiliovonagenetgsm3gbilisimdataportmessagebirdcustomhotptotpnativeexpoone-signalaws_sespostmarksendgridsparkpostsmtpcustom-oauth2amazonapplee-devletdribbbledropboxfacebookgithubgooglelinkedinmicrosoftslackspotifytwittersamlldap

results.identities.
type
string
Zorunlu

Mevcut Değerler: smsotppushemailsocialenterprise

results.identities.
user_id
string
Zorunlu

PlusAuth user's id

results.identities.
details
object
Zorunlu

Raw user object from the connection

results.
last_login
string

User's last login datetime in the ISO 8601 format according to universal time

results.
login_attempts
integer
min0
max
20000

Failed login attempts of user. It will reset to 0 after successful login.

results.
name
string

End-User's full name in displayable form including all name parts, possibly including titles and suffixes, ordered according to the End-User's locale and preferences.

results.
phone_number
string

End-User's preferred phone number. It will be stored in E.164 format.

results.
phone_number_verified
boolean

true if the End-User's phone number has been verified; otherwise false. If SMS MFA is enabled this value will be used to determine whether End-User has verified it's phone or not.

results.
picture
string

URI reference of the End-User's profile picture.

results.
username
string

End-User's username

results.
metadata
object

Additional metadata for your End-User. It must be an object containing 10 fields at max with keys and values no more than 1024 characters. Values can be only one of the types string, number and boolean. You can also use "null" as value to make metadata consistent across other users.

results.
profile
object
results.profile.
addresses
array
results.profile.addresses.
city
string

City or locality component.

results.profile.addresses.
country
string

Country name component.

results.profile.addresses.
first_name
string
results.profile.addresses.
id
string

Identifier for user address. Example: Delivery Address, Billing Address etc.

results.profile.addresses.
is_primary
boolean
results.profile.addresses.
last_name
string
results.profile.addresses.
state
string

State, province, prefecture or region component.

results.profile.addresses.
street_address
string

Full street address component, which MAY include house number, street name, Post Office Box, and multi-line extended street address information. This field may contain multiple lines, separated by newline characters.

results.profile.addresses.
street_address_2
string

Full street address component, which MAY include house number, street name, Post Office Box, and multi-line extended street address information. This field may contain multiple lines, separated by newline characters.

results.profile.addresses.
zip_code
string

Zip code or postal code component.

results.profile.
birthdate
string

End-User's birthday. ISO 8601:2004 YYYY-MM-DD format. The year may be 0000, indicating that it is omitted. To represent only the year, YYYY format is preferred.

results.profile.
family_name
string

Surname(s) or last name(s) of the End-User. Note that in some cultures, people can have multiple family names or no family name; all can be present, with the names being separated by space characters.

results.profile.
gender
string, integer
min-10
max
10

Short code of End-User's gender.

results.profile.
given_name
string

Given name(s) or first name(s) of the End-User. Note that in some cultures, people can have multiple given names; all can be present, with the names being separated by space characters.

results.profile.
locale
string

End-User's locale. For example, en-US or fr-CA.

results.profile.
middle_name
string

Middle name(s) of the End-User. Note that in some cultures, people can have multiple middle names; all can be present, with the names being separated by space characters. Also note that in some cultures, middle names are not used.

results.profile.
nickname
string

Casual name of the End-User that may or may not be the same as the given_name. For instance, a nickname value of Mike might be returned alongside a given_name value of Michael.

results.profile.
profile_page
string

URI reference for the End-User's profile page.

results.profile.
website
string

URI reference for the End-User's Web page or blog.

results.profile.
zoneinfo
string

String from zoneinfo time zone database representing the End-User's time zone. For example, Europe/Paris or America/Los_Angeles.

total
integer