List People

List people in your organization. One of the following permissions is required to run this action:

• spark:people_read
• spark-admin:people_read

External Documentation

To learn more, visit the Cisco Webex documentation.

​

Basic Parameters

Parameter	Description
Calling Data	Include Webex Calling user details in the response. Only supported for Admin users.
Display Name	List people whose name starts with this string. For non-admin users, either this or Email are required.
Email	List people with this email address. For non-admin users, either this or Display Name are required.
Limit	Limit the maximum number of people in the response. If Calling Data is true, the limit of the people returned is 100.
People IDs	List people by ID. Accepts up to 85 person IDs separated by commas.
Roles	Comma separated list of role ids to list people by. Lookup by roles is only supported for Admin users for the people within the same org.

​

Advanced Parameters

Parameter	Description
Org ID	List people in this organization. Only admin users of another organization (such as partners) may use this parameter.

​

Example Output

{
	"notFoundIds": null,
	"items": [
		{
			"id": "<string>",
			"emails": [
				"<string>"
			],
			"displayName": "<string>",
			"nickName": "<string>",
			"firstName": "<string>",
			"lastName": "<string>",
			"orgId": "<string>",
			"created": "2005-09-12T18:56:13.378Z",
			"lastModified": "2009-02-05T01:46:58.640Z",
			"timeZone": "<string>",
			"lastActivity": "2019-03-22T01:51:51.847Z",
			"status": "<string>",
			"type": "<string>",
			"addresses": [
				{
					"country": "<string>",
					"locality": "<string>",
					"region": "<string>",
					"streetAddress": "<string>",
					"type": "<string>",
					"postalCode": "<string>"
				}
			]
		}
	]
}