Share via

/users.json - Get

Definition

https://www.yammer.com/api/v1/users.json

Parameters

Name In Required Type Description
page query integer Indicates the page of users to return. Used when paging through users. Example: page=2.
num_per_page query integer Controls the number of users returned per page. Defaults to 50 users. Example: num_per_page=5.
letter query string Filter users beginning with the given character. Example: letter=c.
reverse query boolean Reverses the order of results returned. Example: reverse=true.
sort_by query string Sort results by number of messages or followers, instead of the default behavior of sorting alphabetically. Examples: sort_by=[messages] or sort_by=[followers].
show_pending query boolean By default, only active users are returned. The show_pending user will include pending users that have not activated their Yammer account. The pending user state is deprecated and only active users are present in M365 Native Mode networks.

Documentation

The users endpoint returns a list of users within the network which can be paged through to get all users in the network. This endpoint will work in freemium and enterprise networks.

Many developers will find that there are better solutions for getting user data:

  • Azure Active Directory PowerShell for Graph module which is the recommended way for getting user data for Microsoft 365 users. All users in a Native Mode network are valid Azure AD users.
  • Data Export API which allows all users to be retrieved quickly in large networks without paging through many API responses.
  • Autocomplete which enables lookup of individual users quickly. Example usage might be in a user lookup feature where the name of a user is being input.

These solutions are more efficient for common use cases arising during development and avoid the need to manage rate-limiting.

SUPPORTED NETWORK TYPES

  • Freemium/Basic
  • Enterprise without Native Mode
  • Enterprise with M365 Native Mode (Azure AD PowerShell or APIs are recommended for user operations.)