Get a list of all users
This guide covers how to retrieve a list of all user accounts for a specific customer. You can retrieve the list either in the Microsoft Partner Center web UI or through API calls.
Web UI
To retrieve a list of all of a customer's users in Partner Center, go to Customers > Users and Licenses.
PowerShell
To retrieve the collection of all user accounts for a specified customer, enter the following commands:
$user = Get-PCCustomerUser -TenantId '<customer identifier>'
C#
To retrieve the collection of all user accounts for a specified customer, do the following:
- To identify the customer, call the IAggregatePartner.Customers.ById method with the specified customer ID.
- To retrieve the collection, call the Users.Get or GetAsync method.
// IAggregatePartner partnerOperations;
// string selectedCustomerId;
// Get customer users collection.
var customerUsers = partnerOperations.Customers.ById(selectedCustomerId).Users.Get();
REST API
Request syntax
Method | Request URI |
---|---|
GET | {baseURL}/v1/customers/{customer-tenant-id}/users HTTP/1.1 |
URI parameters
Name | Name | Description |
---|---|---|
customer-tenant-id | GUID | A GUID that represents the customer. |
Request example
GET https://api.partnercenter.microsoft.com/v1/customers/4d3cf487-70f4-4e1e-9ff1-b2bfce8d9f04/users HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 5d845377-5b7d-4cd4-98f6-19e5ae3faa81
MS-CorrelationId: 5a3d64d4-4490-4932-bf5e-0dc9a58f27ca
X-Locale: en-US
Host: api.partnercenter.microsoft.com
Response example
If the request is successful, this method returns a collection of users.
HTTP/1.1 200 OK
Content-Length: 1030
Content-Type: application/json; charset=utf-8
MS-CorrelationId: 5a3d64d4-4490-4932-bf5e-0dc9a58f27ca
MS-RequestId: 5d845377-5b7d-4cd4-98f6-19e5ae3faa81
MS-CV: 6zmKqrSFB0+t7m3y.0
MS-ServerId: 101112616
Date: Wed, 21 Dec 2016 21:13:24 GMT
{
"totalCount": 2,
"items": [{
"usageLocation": "US",
"id": "a9ef48bb-8758-4590-a312-d4a47bfaded4",
"userPrincipalName": "Daniel@dtdemocspcustomer005.onmicrosoft.com",
"firstName": "Daniel",
"lastName": "Tsai",
"displayName": "Daniel Tsai",
"userDomainType": "none",
"state": "active",
"links": {
"self": {
"uri": "/customers/4d3cf487-70f4-4e1e-9ff1-b2bfce8d9f04/users/a9ef48bb-8758-4590-a312-d4a47bfaded4",
"method": "GET",
"headers": []
}
},
"attributes": {
"objectType": "CustomerUser"
}
}, {
"id": "6e668259-1f09-479d-bcb8-d9b03e826b8d",
"userPrincipalName": "admin@dtdemocspcustomer005.onmicrosoft.com",
"firstName": "Daniel",
"lastName": "Tsai",
"displayName": "DT Demo CSP Customer 005",
"userDomainType": "none",
"state": "active",
"links": {
"self": {
"uri": "/customers/4d3cf487-70f4-4e1e-9ff1-b2bfce8d9f04/users/6e668259-1f09-479d-bcb8-d9b03e826b8d",
"method": "GET",
"headers": []
}
},
"attributes": {
"objectType": "CustomerUser"
}
}
],
"links": {
"self": {
"uri": "/customers/4d3cf487-70f4-4e1e-9ff1-b2bfce8d9f04/users",
"method": "GET",
"headers": []
}
},
"attributes": {
"objectType": "Collection"
}
}
Next steps
- Learn about APIs for Azure CSP integration.
- View a list of Azure CSP integration scenarios.