Get List of End Users and their M365 Teams Phone System Attributes
This request retrieves a list of M365 users and their Microsoft Teams Phone System attributes for a specific customer.
| ● | This functionality is only supported for Essentials Plus and Pro services; ensure you have a secure connection for synchronization between Live Platform and Microsoft Teams (see Secure Connection with Customer M365 Tenant Platform). |
| ● | For Hosted Essentials services, users must be managed directly in their Teams admin center. |
URI
Copy
{{baseUrl}}/api/v3/customer/{umpCustomerGuid}/userHTTP Method
GET
Request Parameters
|
Parameter |
Type |
Description |
||||||
|---|---|---|---|---|---|---|---|---|
|
customerGuid |
string($uuid) (path) |
umpCustomerGuid' value created in the Live Platformcustomer tenant SQL database directory:
Extract this value using Get Services Brief Details (V3) or Get Customers Brief Details (V2) searching for the matching Short Name of the service. |
||||||
|
Page Number |
integer Default value: 1 |
Page number in range to retrieve. |
||||||
|
Page Size |
integer Default minimum value: 2 maximum: 10000 |
Number of pages in range to retrieve. |
||||||
|
X-Ovoc-Channel-Id |
integer |
The Live Platform channel "id". When specified, data retrieval is scoped to only customers belonging to the specified channel. See Get List of Channels to extract this value. |
||||||
|
X-IAM-Account-Id |
string |
The Live Platform "iamAccountId" of the channel. When specified, data retrieval is scoped to only customers belonging to the specified channel. See Get List of Channels to extract this value. |
Example Response
Copy
{
"currentPage": 1,
"pageSize": 10,
"totalPages": 4,
"totalRecords": 37,
"data": [
{
"Identity": "04b6aa84-eb73-4f46-ba4a-200f86a2563a",
"Status": "----",
"SipAddress": "sip:meganb@m365x33712745.onmicrosoft.com",
"LineURI": null,
"HostingProvider": "sipfed.online.lync.com",
"HybridPstnSiteName": null,
"UsageLocation": "US",
"RegistrarPool": null,
"CallForward": "",
"ObjectId": "04B6AA84-EB73-4F46-BA4A-200F86A2563A",
"WebName": "Megan Bowen",
"UserType": "TeamsOnly",
"PsCount": 0,
"IsManaged": null,
"Department": null,
"TenantId": "7e24d47c-eb72-439a-84e4-aea1bdb1eed9",
"UserPrincipalName": "MeganB@M365x33712745.OnMicrosoft.com",
"MsInterpretedUserType": "PureOnlineTeamsOnlyUser",
"EnterpriseVoiceEnabled": false,
"OnlineVoiceRoutingPolicy": "",
"OnlinePstnGateway": ""
},
{
"Identity": "0a7db8a7-ef2d-4794-81e1-518fb15770d1",
"Status": "----",
"SipAddress": null,
"LineURI": null,
"HostingProvider": null,
"HybridPstnSiteName": null,
"UsageLocation": "US",
"RegistrarPool": null,
"CallForward": "",
"ObjectId": "0A7DB8A7-EF2D-4794-81E1-518FB15770D1",
"WebName": "Mallory Cortez",
"UserType": "NoService",
"PsCount": 0,
"IsManaged": null,
"Department": null,
"TenantId": "7e24d47c-eb72-439a-84e4-aea1bdb1eed9",
"UserPrincipalName": "MalloryC@M365x33712745.OnMicrosoft.com",
"MsInterpretedUserType": "PureOnlineUserWithNoService",
"EnterpriseVoiceEnabled": false,
"OnlineVoiceRoutingPolicy": "",
"OnlinePstnGateway": ""
},
{
"Identity": "161476df-e508-4a29-b27e-09b61903b82b",
"Status": "----",
"SipAddress": null,
"LineURI": null,
"HostingProvider": null,
"HybridPstnSiteName": null,
"UsageLocation": "US",
"RegistrarPool": null,
"CallForward": "",
"ObjectId": "161476DF-E508-4A29-B27E-09B61903B82B",
"WebName": "Cameron White",
"UserType": "NoService",
"PsCount": 0,
"IsManaged": null,
"Department": null,
"TenantId": "7e24d47c-eb72-439a-84e4-aea1bdb1eed9",
"UserPrincipalName": "CameronW@M365x33712745.OnMicrosoft.com",
"MsInterpretedUserType": "PureOnlineUserWithNoService",
"EnterpriseVoiceEnabled": false,
"OnlineVoiceRoutingPolicy": "",
"OnlinePstnGateway": ""
},
{
"Identity": "22a79328-9325-4bb8-b549-5731446a2a24",
"Status": "----",
"SipAddress": "sip:jonis@m365x33712745.onmicrosoft.com",
"LineURI": null,
"HostingProvider": "sipfed.online.lync.com",
"HybridPstnSiteName": null,
"UsageLocation": "US",
"RegistrarPool": null,
"CallForward": "",
"ObjectId": "22A79328-9325-4BB8-B549-5731446A2A24",
"WebName": "Joni Sherman",
"UserType": "TeamsOnly",
"PsCount": 0,
"IsManaged": null,
"Department": null,
"TenantId": "7e24d47c-eb72-439a-84e4-aea1bdb1eed9",
"UserPrincipalName": "JoniS@M365x33712745.OnMicrosoft.com",
"MsInterpretedUserType": "PureOnlineTeamsOnlyUser",
"EnterpriseVoiceEnabled": false,
"OnlineVoiceRoutingPolicy": "",
"OnlinePstnGateway": ""
},
{
"Identity": "23727739-a224-4a23-a2c0-f4c4d9453875",
"Status": "----",
"SipAddress": null,
"LineURI": null,
"HostingProvider": null,
"HybridPstnSiteName": null,
"UsageLocation": "US",
"RegistrarPool": null,
"CallForward": "",
"ObjectId": "23727739-A224-4A23-A2C0-F4C4D9453875",
"WebName": "Automate Bot",
"UserType": "NoService",
"PsCount": 0,
"IsManaged": null,
"Department": null,
"TenantId": "7e24d47c-eb72-439a-84e4-aea1bdb1eed9",
"UserPrincipalName": "AutomateB@M365x33712745.OnMicrosoft.com",
"MsInterpretedUserType": "PureOnlineUserWithNoService",
"EnterpriseVoiceEnabled": false,
"OnlineVoiceRoutingPolicy": "",
"OnlinePstnGateway": ""
},
{
"Identity": "285f91c7-7ff4-4886-a80b-96eb417f28de",
"Status": "----",
"SipAddress": null,
"LineURI": null,
"HostingProvider": null,
"HybridPstnSiteName": null,
"UsageLocation": "US",
"RegistrarPool": null,
"CallForward": "",
"ObjectId": "285F91C7-7FF4-4886-A80B-96EB417F28DE",
"WebName": "Microsoft Service Account",
"UserType": "NoService",
"PsCount": 0,
"IsManaged": null,
"Department": null,
"TenantId": "7e24d47c-eb72-439a-84e4-aea1bdb1eed9",
"UserPrincipalName": "ms-serviceaccount@M365x33712745.OnMicrosoft.com",
"MsInterpretedUserType": "PureOnlineUserWithNoService",
"EnterpriseVoiceEnabled": false,
"OnlineVoiceRoutingPolicy": "",
"OnlinePstnGateway": ""
},
{
"Identity": "47aaa67d-453f-4ce0-a903-19f7f5e08e1c",
"Status": "----",
"SipAddress": "sip:diegos@m365x33712745.onmicrosoft.com",
"LineURI": null,
"HostingProvider": "sipfed.online.lync.com",
"HybridPstnSiteName": null,
"UsageLocation": "US",
"RegistrarPool": null,
"CallForward": "",
"ObjectId": "47AAA67D-453F-4CE0-A903-19F7F5E08E1C",
"WebName": "Diego Siciliani",
"UserType": "TeamsOnly",
"PsCount": 0,
"IsManaged": null,
"Department": null,
"TenantId": "7e24d47c-eb72-439a-84e4-aea1bdb1eed9",
"UserPrincipalName": "DiegoS@M365x33712745.OnMicrosoft.com",
"MsInterpretedUserType": "PureOnlineTeamsOnlyUser",
"EnterpriseVoiceEnabled": false,
"OnlineVoiceRoutingPolicy": "",
"OnlinePstnGateway": ""
},
{
"Identity": "47d18bc6-4919-4ab7-9661-5f1be0630155",
"Status": "----",
"SipAddress": null,
"LineURI": null,
"HostingProvider": "sipfed.online.lync.com",
"HybridPstnSiteName": null,
"UsageLocation": "US",
"RegistrarPool": null,
"CallForward": "",
"ObjectId": "47D18BC6-4919-4AB7-9661-5F1BE0630155",
"WebName": "Allan Deyoung",
"UserType": "NoService",
"PsCount": 0,
"IsManaged": null,
"Department": null,
"TenantId": "7e24d47c-eb72-439a-84e4-aea1bdb1eed9",
"UserPrincipalName": "AllanD@M365x33712745.OnMicrosoft.com",
"MsInterpretedUserType": "PureOnlineTeamsOnlyUserWithNoService",
"EnterpriseVoiceEnabled": false,
"OnlineVoiceRoutingPolicy": "",
"OnlinePstnGateway": ""
},
{
"Identity": "49243d55-bc4a-4cfb-9ad9-f67d28cac57b",
"Status": "----",
"SipAddress": null,
"LineURI": null,
"HostingProvider": null,
"HybridPstnSiteName": null,
"UsageLocation": null,
"RegistrarPool": null,
"CallForward": "",
"ObjectId": "49243D55-BC4A-4CFB-9AD9-F67D28CAC57B",
"WebName": "Brian Johnson (TAILSPIN)",
"UserType": "NoService",
"PsCount": 0,
"IsManaged": null,
"Department": null,
"TenantId": "7e24d47c-eb72-439a-84e4-aea1bdb1eed9",
"UserPrincipalName": "BrianJ@M365x33712745.OnMicrosoft.com",
"MsInterpretedUserType": "PureOnlineUserWithNoService",
"EnterpriseVoiceEnabled": false,
"OnlineVoiceRoutingPolicy": "",
"OnlinePstnGateway": ""
},
{
"Identity": "4adcbb3b-a156-4705-a5a5-33ba1f0c66a8",
"Status": "----",
"SipAddress": null,
"LineURI": null,
"HostingProvider": null,
"HybridPstnSiteName": null,
"UsageLocation": "US",
"RegistrarPool": null,
"CallForward": "",
"ObjectId": "4ADCBB3B-A156-4705-A5A5-33BA1F0C66A8",
"WebName": "Bianca Pisani",
"UserType": "NoService",
"PsCount": 0,
"IsManaged": null,
"Department": null,
"TenantId": "7e24d47c-eb72-439a-84e4-aea1bdb1eed9",
"UserPrincipalName": "BiancaP@M365x33712745.OnMicrosoft.com",
"MsInterpretedUserType": "PureOnlineUserWithNoService",
"EnterpriseVoiceEnabled": false,
"OnlineVoiceRoutingPolicy": "",
"OnlinePstnGateway": ""
}
]
}Example response with Channel scope header parameter
Copy
{
"currentPage": 1,
"pageSize": 10,
"totalPages": 2,
"totalRecords": 18,
"data": [
{
"Identity": "223a7851-897a-4ea9-8647-baf9bcffcaa8",
"Status": "----",
"SipAddress": "sip:pradeepg@1xwzg5.onmicrosoft.com",
"LineURI": "tel:+6138485600",
"HostingProvider": "sipfed.online.lync.com",
"HybridPstnSiteName": null,
"UsageLocation": "US",
"RegistrarPool": null,
"CallForward": "",
"ObjectId": "223A7851-897A-4EA9-8647-BAF9BCFFCAA8",
"WebName": "Pradeep Gupta",
"UserType": "TeamsOnly",
"PsCount": 0,
"IsManaged": null,
"Department": "Finance",
"TenantId": "3bc57cac-5794-457f-ad36-2c88cade9dbb",
"UserPrincipalName": "PradeepG@1xwzg5.onmicrosoft.com",
"MsInterpretedUserType": "PureOnlineTeamsOnlyUser",
"EnterpriseVoiceEnabled": true,
"OnlineVoiceRoutingPolicy": "",
"OnlinePstnGateway": ""
},
{
"Identity": "25dbacc4-34df-4201-ab2a-bb1fc34e9ee7",
"Status": "----",
"SipAddress": "sip:miriamg@1xwzg5.onmicrosoft.com",
"LineURI": "tel:+6138485601",
"HostingProvider": "sipfed.online.lync.com",
"HybridPstnSiteName": null,
"UsageLocation": "US",
"RegistrarPool": null,
"CallForward": "",
"ObjectId": "25DBACC4-34DF-4201-AB2A-BB1FC34E9EE7",
"WebName": "Miriam Graham",
"UserType": "TeamsOnly",
"PsCount": 0,
"IsManaged": null,
"Department": "Sales & Marketing",
"TenantId": "3bc57cac-5794-457f-ad36-2c88cade9dbb",
"UserPrincipalName": "MiriamG@1xwzg5.onmicrosoft.com",
"MsInterpretedUserType": "PureOnlineTeamsOnlyUser",
"EnterpriseVoiceEnabled": true,
"OnlineVoiceRoutingPolicy": "",
"OnlinePstnGateway": ""
},
{
"Identity": "3a7d8987-05dd-441c-af6e-d569a342839f",
"Status": "----",
"SipAddress": "sip:isaiahl@1xwzg5.onmicrosoft.com",
"LineURI": "tel:+6138485603",
"HostingProvider": "sipfed.online.lync.com",
"HybridPstnSiteName": null,
"UsageLocation": "US",
"RegistrarPool": null,
"CallForward": "",
"ObjectId": "3A7D8987-05DD-441C-AF6E-D569A342839F",
"WebName": "Isaiah Langer",
"UserType": "TeamsOnly",
"PsCount": 0,
"IsManaged": null,
"Department": "Sales",
"TenantId": "3bc57cac-5794-457f-ad36-2c88cade9dbb",
"UserPrincipalName": "IsaiahL@1xwzg5.onmicrosoft.com",
"MsInterpretedUserType": "PureOnlineTeamsOnlyUser",
"EnterpriseVoiceEnabled": true,
"OnlineVoiceRoutingPolicy": "",
"OnlinePstnGateway": ""
},
{
"Identity": "46c2e271-3c48-4df1-861a-e01d3fb04ed5",
"Status": "----",
"SipAddress": "sip:gradya@1xwzg5.onmicrosoft.com",
"LineURI": "tel:+6138485604",
"HostingProvider": "sipfed.online.lync.com",
"HybridPstnSiteName": null,
"UsageLocation": "US",
"RegistrarPool": null,
"CallForward": "",
"ObjectId": "46C2E271-3C48-4DF1-861A-E01D3FB04ED5",
"WebName": "Grady Archie",
"UserType": "TeamsOnly",
"PsCount": 0,
"IsManaged": null,
"Department": "R&D",
"TenantId": "3bc57cac-5794-457f-ad36-2c88cade9dbb",
"UserPrincipalName": "GradyA@1xwzg5.onmicrosoft.com",
"MsInterpretedUserType": "PureOnlineTeamsOnlyUser",
"EnterpriseVoiceEnabled": true,
"OnlineVoiceRoutingPolicy": "",
"OnlinePstnGateway": ""
},
{
"Identity": "4de61c20-8830-4b8d-8764-0047ff0f0cc9",
"Status": "----",
"SipAddress": "sip:lidiah@1xwzg5.onmicrosoft.com",
"LineURI": "tel:+6138485605",
"HostingProvider": "sipfed.online.lync.com",
"HybridPstnSiteName": null,
"UsageLocation": "US",
"RegistrarPool": null,
"CallForward": "",
"ObjectId": "4DE61C20-8830-4B8D-8764-0047FF0F0CC9",
"WebName": "Lidia Holloway",
"UserType": "TeamsOnly",
"PsCount": 0,
"IsManaged": null,
"Department": "Engineering",
"TenantId": "3bc57cac-5794-457f-ad36-2c88cade9dbb",
"UserPrincipalName": "LidiaH@1xwzg5.onmicrosoft.com",
"MsInterpretedUserType": "PureOnlineTeamsOnlyUser",
"EnterpriseVoiceEnabled": true,
"OnlineVoiceRoutingPolicy": "",
"OnlinePstnGateway": ""
},
{
"Identity": "69c2f0f9-ada1-4f7a-bb08-4635ec76acd8",
"Status": "----",
"SipAddress": "sip:ump-activation-1778402320@blackburn.sandbox1.audiocodes.be",
"LineURI": null,
"HostingProvider": "sipfed.online.lync.com",
"HybridPstnSiteName": null,
"UsageLocation": "BE",
"RegistrarPool": null,
"CallForward": "",
"ObjectId": "69C2F0F9-ADA1-4F7A-BB08-4635EC76ACD8",
"WebName": "ump-activation-1778402320",
"UserType": "TeamsOnly",
"PsCount": 0,
"IsManaged": null,
"Department": null,
"TenantId": "3bc57cac-5794-457f-ad36-2c88cade9dbb",
"UserPrincipalName": "ump-activation-1778402320@Blackburn.sandbox1.audiocodes.be",
"MsInterpretedUserType": "PureOnlineTeamsOnlyUser",
"EnterpriseVoiceEnabled": false,
"OnlineVoiceRoutingPolicy": "",
"OnlinePstnGateway": ""
},
{
"Identity": "75beea47-18f2-4b2b-a005-ab82b464a8f7",
"Status": "----",
"SipAddress": "sip:bradb@1xwzg5.onmicrosoft.com",
"LineURI": "tel:+6138485606",
"HostingProvider": "sipfed.online.lync.com",
"HybridPstnSiteName": null,
"UsageLocation": "IE",
"RegistrarPool": null,
"CallForward": "",
"ObjectId": "75BEEA47-18F2-4B2B-A005-AB82B464A8F7",
"WebName": "Brad Brzezinski",
"UserType": "TeamsOnly",
"PsCount": 0,
"IsManaged": null,
"Department": null,
"TenantId": "3bc57cac-5794-457f-ad36-2c88cade9dbb",
"UserPrincipalName": "Bradb@1xwzg5.onmicrosoft.com",
"MsInterpretedUserType": "PureOnlineTeamsOnlyUser",
"EnterpriseVoiceEnabled": true,
"OnlineVoiceRoutingPolicy": "",
"OnlinePstnGateway": ""
},
{
"Identity": "89d3d96c-891a-47f0-90d3-d20af231564a",
"Status": "----",
"SipAddress": "sip:lynner@1xwzg5.onmicrosoft.com",
"LineURI": "tel:+6138485607",
"HostingProvider": "sipfed.online.lync.com",
"HybridPstnSiteName": null,
"UsageLocation": "US",
"RegistrarPool": null,
"CallForward": "",
"ObjectId": "89D3D96C-891A-47F0-90D3-D20AF231564A",
"WebName": "Lynne Robbins",
"UserType": "TeamsOnly",
"PsCount": 0,
"IsManaged": null,
"Department": "Retail",
"TenantId": "3bc57cac-5794-457f-ad36-2c88cade9dbb",
"UserPrincipalName": "LynneR@1xwzg5.onmicrosoft.com",
"MsInterpretedUserType": "PureOnlineTeamsOnlyUser",
"EnterpriseVoiceEnabled": true,
"OnlineVoiceRoutingPolicy": "",
"OnlinePstnGateway": ""
},
{
"Identity": "8e0fa707-a28b-451d-8432-97f1c67f779f",
"Status": "----",
"SipAddress": "sip:nestorw@1xwzg5.onmicrosoft.com",
"LineURI": "tel:+6138485608",
"HostingProvider": "sipfed.online.lync.com",
"HybridPstnSiteName": null,
"UsageLocation": "US",
"RegistrarPool": null,
"CallForward": "",
"ObjectId": "8E0FA707-A28B-451D-8432-97F1C67F779F",
"WebName": "Nestor Wilke",
"UserType": "TeamsOnly",
"PsCount": 0,
"IsManaged": null,
"Department": "Operations",
"TenantId": "3bc57cac-5794-457f-ad36-2c88cade9dbb",
"UserPrincipalName": "NestorW@1xwzg5.onmicrosoft.com",
"MsInterpretedUserType": "PureOnlineTeamsOnlyUser",
"EnterpriseVoiceEnabled": true,
"OnlineVoiceRoutingPolicy": "",
"OnlinePstnGateway": ""
},
{
"Identity": "aaa095a2-8000-48fd-9e5b-7d8bc1fcf9c6",
"Status": "----",
"SipAddress": "sip:leeg@1xwzg5.onmicrosoft.com",
"LineURI": "tel:+6138485609",
"HostingProvider": "sipfed.online.lync.com",
"HybridPstnSiteName": null,
"UsageLocation": "US",
"RegistrarPool": null,
"CallForward": "",
"ObjectId": "AAA095A2-8000-48FD-9E5B-7D8BC1FCF9C6",
"WebName": "Lee Gu",
"UserType": "TeamsOnly",
"PsCount": 0,
"IsManaged": null,
"Department": "Manufacturing",
"TenantId": "3bc57cac-5794-457f-ad36-2c88cade9dbb",
"UserPrincipalName": "LeeG@1xwzg5.onmicrosoft.com",
"MsInterpretedUserType": "PureOnlineTeamsOnlyUser",
"EnterpriseVoiceEnabled": true,
"OnlineVoiceRoutingPolicy": "",
"OnlinePstnGateway": ""
}
]
}Response
| ■ | 200 OK |
|
Parameter |
Type |
Description |
||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Index summary data |
integer |
|
||||||||||||
|
Identity |
string($uuid) (path) |
Live Platform generated customer Guid. |
||||||||||||
|
Status |
- |
- |
||||||||||||
|
SipAddress |
|
Email address of the SIP user, for example, sip:meganb@m365x33712745.onmicrosoft.com |
||||||||||||
|
CallForward |
|
Indicates whether Call Forwarding is enabled for the user. |
||||||||||||
|
Department |
string |
Active Directory User department. |
||||||||||||
|
WebName |
string |
Name of the M365 customer tenant user. |
||||||||||||
|
SipAddress |
string |
M365 user SIP address. For example, sip:adelev@m365x21689653.onmicrosoft.com |
||||||||||||
|
LineURI |
string |
Line URI assigned to user. |
||||||||||||
|
HostingProvider |
string |
sipfed.online.lync.com |
||||||||||||
|
HybridPstnSiteName |
string |
Name of the site location |
||||||||||||
|
UsageLocation |
string |
Usage Location as defined in the customer tenant Microsoft Entra admin center (see Set Usage Location). |
||||||||||||
|
RegistrarPool |
string |
- | ||||||||||||
|
CallForward |
string |
|
||||||||||||
|
ObjectId |
string |
- | ||||||||||||
|
WebName |
string |
For example, Megan Bowen |
||||||||||||
|
PsCount |
integer |
- | ||||||||||||
|
IsManaged |
boolean |
- | ||||||||||||
|
Department |
string |
Indicates the name of the Microsoft Azure Active Directory department object. |
||||||||||||
|
OnlineVoiceRoutingPolicy |
string |
Default: unrestricted or SiteLocationTag-Unrestricted |
||||||||||||
|
TenantId |
string |
Microsoft Azure subscription Tenant ID of the customer attached to the service. |
||||||||||||
|
MsInterpretedUserType |
string |
PureOnlineTeamsOnlyUser |
||||||||||||
|
UserPrincipalName |
string |
UPN, for example, MeganB@M365x33712745.OnMicrosoft.com |
||||||||||||
|
EnterpriseVoiceEnabled |
boolean |
Indicates whether Enterprise Voice is enabled. |
||||||||||||
|
OnlineVoiceRoutingPolicy |
string |
Name of the OnlineVoiceRoutingPolicy applied to user through LifeCycle Management templates (Direct Routing only). |
||||||||||||
|
OnlinePstnGateway |
string |
Name of the OnlinePSTNGateway of the Service Provider or Customer sub domain for connecting calls between Microsoft Teams and Calling trunk. |
| ■ | 400 Bad Request |
| ■ | 500 Internal Server Error |