Organization API › Members
List members
GET/api/v1/users
Every member of the organization, in the order they joined. With
permission, only the members who hold that permission (through their
standing, a role or a team): the people a picker should offer for a job.
Permission (API-key scope): identity:user:read.
Authorization
bearerAuth(identity:user:read)apiKeyHeader(identity:user:read)
Parameters
Query parameters
permissionstringA permission from the catalog, for exampleoncall:alert:respond.
Responses
200
The members.
dataarray of Member requiredShow Member properties
idstring requiredemailstring (email) requirednamestring requiredtitlestringroleStanding requiredorg_idstring requiredstatusstring requiredmfa_enabledbooleanmfa_setup_requiredbooleanOnly on/users/me: the login policy requires MFA and the person has not set it up.has_passwordbooleanfalsefor people who sign in only with GitHub or Google.phone_numberstringphone_verifiedbooleancreated_atstring (date-time) requiredupdated_atstring (date-time) required
successboolean required
400
permission is not in the catalog (UNKNOWN_PERMISSION).
errorobject requiredcodestring requiredMachine-readable code. Branch on this.messagestring requiredHuman-readable explanation.request_idstringThe response'sX-Request-ID; quote it to support.
401
No API key was sent, or it is unknown, revoked or expired (UNAUTHORIZED).
errorobject requiredcodestring requiredMachine-readable code. Branch on this.messagestring requiredHuman-readable explanation.request_idstringThe response'sX-Request-ID; quote it to support.
403
The key lacks the scope this endpoint needs (FORBIDDEN).
errorobject requiredcodestring requiredMachine-readable code. Branch on this.messagestring requiredHuman-readable explanation.request_idstringThe response'sX-Request-ID; quote it to support.
429
Too many requests (RATE_LIMITED). Wait Retry-After seconds.
Retry-AfterintegerSeconds to wait.
errorobject requiredcodestring requiredMachine-readable code. Branch on this.messagestring requiredHuman-readable explanation.request_idstringThe response'sX-Request-ID; quote it to support.
500
Something went wrong on EvoHub's side (INTERNAL_ERROR). Retry later.
errorobject requiredcodestring requiredMachine-readable code. Branch on this.messagestring requiredHuman-readable explanation.request_idstringThe response'sX-Request-ID; quote it to support.
Example request
curl -X GET 'https://evohub.io/api/v1/users' \
-H 'Authorization: Bearer <TOKEN>'