Return one page of the people in the company account in the access token, with their role, whether they have registered, and their office and company. The account is taken from the token only. search matches the whole email address, ignoring case, when it contains @, and otherwise any part of the full name, ignoring case. roleIds keeps people holding any of the listed roles (ids from GET /v1/account/roles); an id that is not one of the account's roles matches nobody, and a person who holds only a legacy role name, with no role id, is never matched by it. registered keeps registered people when true and everyone else, invited or not, when false. attributeFilter keeps people holding any listed value of an organizational attribute, for every attribute given (ids from GET /v1/account/attributes); an unknown or retired id, an id of another account, or any filter while the account's attribute data is not in use is a 422, and so is a filter matching more than 400 people, the most one upstream read can carry. A person whose attribute values are stored under an id that is not an upstream user id is never matched by it. All of them combine, and meta.totalCount counts the matching people. sort orders by name, email, registration or creation, with ties broken the same way on every page; absent, newest first. limit defaults to 50 and may be at most 200. office and company are null when the person has none, and for everyone while the account's attribute data is not in use. Only account administrators may read it.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
401Missing or invalid authentication
403The caller is not an administrator of the account
422limit or offset is out of range, search is too long, roleIds is not a list of role ids, sort is unknown, or an attributeFilter is malformed, names an id that is not an active value of the account, or matches more than 400 people
502Upstream returned a malformed user record
503The account's people are temporarily unavailable