GET - User Service Instance Search
Search for service instances for a user, group or service provider.
Parameters
user_id (str): ID of the target user
service_provider_id (str, optional): Service provider ID of the target
group_id (str, optional): Group ID of the target
filter (str, optional): Filter criteria, supported filters below. Defaults to None.
filter_type (str, optional): Options: equals, startsWith, endsWith, contains or endsWith. Defaults to None.
filter_value (str, optional): Value filtering on e.g. firstName. Defaults to None.
limit (int, optional): Limits the amount of values API returns. Defaults to None.
extended (bool, optional): If True, returns the full user profile. Defaults to False.
Returns
Dict: A dictionary containing all the service instances for the user, group or service provider.
How To Use:
my_api.services.get_user_service_instance_search(
user_id="user_id",
service_provider_id="service_provider_id",
group_id="group_id",
filter="firstName",
filter_type="startsWith",
filter_value="J",
limit=10,
extended=True
)
Example Data Returned (Formatted)
[
{
"serviceType": "User",
"name": "John Doe",
"phoneNumber": "1234567890",
"extension": "1001",
"department": "Sales",
"groupId": "sales_group",
"userId": "[email protected]",
"serviceProviderId": "example_corp",
"userIdShort": "[email protected]",
"domain": "example.com"
},
{
"serviceType": "User",
"name": "Jane Doe",
"phoneNumber": "0987654321",
"extension": "1002",
"department": "Sales",
"groupId": "sales_group",
"userId": "[email protected]",
"serviceProviderId": "example_corp",
"userIdShort": "[email protected]",
"domain": "example.com"
}
]
Last updated
Was this helpful?