PHP (Extension) / Support API / Search Users
Back to Collection Items
<?php
include("chilkat_9_5_0.php");
$http->put_BasicAuth(true);$http->put_Login('login');$http->put_Password('password');$queryParams->UpdateString('query','<string>');$queryParams->UpdateString('external_id','<string>');$resp->GetBodySb($sbResponseBody);$jResp->LoadSb($sbResponseBody);$jResp->put_EmitCompact(false);$jResp->put_I($i);$name = $jResp->stringOf('users[i].name');$active = $jResp->stringOf('users[i].active');$alias = $jResp->stringOf('users[i].alias');$chat_only = $jResp->stringOf('users[i].chat_only');$created_at = $jResp->stringOf('users[i].created_at');$custom_role_id = $jResp->stringOf('users[i].custom_role_id');$default_group_id = $jResp->stringOf('users[i].default_group_id');$details = $jResp->stringOf('users[i].details');$email = $jResp->stringOf('users[i].email');$external_id = $jResp->stringOf('users[i].external_id');$iana_time_zone = $jResp->stringOf('users[i].iana_time_zone');$id = $jResp->stringOf('users[i].id');$last_login_at = $jResp->stringOf('users[i].last_login_at');$locale = $jResp->stringOf('users[i].locale');$locale_id = $jResp->stringOf('users[i].locale_id');$moderator = $jResp->stringOf('users[i].moderator');$notes = $jResp->stringOf('users[i].notes');$only_private_comments = $jResp->stringOf('users[i].only_private_comments');$organization_id = $jResp->stringOf('users[i].organization_id');$phone = $jResp->stringOf('users[i].phone');$In1f = $jResp->BoolOf('users[i].photo.in1f');$Cillumb5 = $jResp->BoolOf('users[i].photo.cillumb5');$remote_photo_url = $jResp->stringOf('users[i].remote_photo_url');$report_csv = $jResp->stringOf('users[i].report_csv');$restricted_agent = $jResp->stringOf('users[i].restricted_agent');$role = $jResp->stringOf('users[i].role');$role_type = $jResp->stringOf('users[i].role_type');$v_shared = $jResp->stringOf('users[i].shared');$shared_agent = $jResp->stringOf('users[i].shared_agent');$shared_phone_number = $jResp->stringOf('users[i].shared_phone_number');$signature = $jResp->stringOf('users[i].signature');$suspended = $jResp->stringOf('users[i].suspended');$tags = $jResp->stringOf('users[i].tags');$ticket_restriction = $jResp->stringOf('users[i].ticket_restriction');$time_zone = $jResp->stringOf('users[i].time_zone');$two_factor_auth_enabled = $jResp->stringOf('users[i].two_factor_auth_enabled');$updated_at = $jResp->stringOf('users[i].updated_at');$url = $jResp->stringOf('users[i].url');$Nisi_e = $jResp->stringOf('users[i].user_fields.nisi_e');$verified = $jResp->stringOf('users[i].verified');$Ut69 = $jResp->BoolOf('users[i].photo.ut69');$Magna_4 = $jResp->IntOf('users[i].photo.magna_4');$Loremcc = $jResp->IntOf('users[i].user_fields.Loremcc');$Dolore7 = $jResp->BoolOf('users[i].user_fields.dolore7');$Pariaturf = $jResp->stringOf('users[i].user_fields.pariaturf');$i = $i + 1;
?>
Curl Command
curl -u login:password -G -d "query=%3Cstring%3E"
-d "external_id=%3Cstring%3E"
-H "Accept: application/json"
https://example.zendesk.com/api/v2/users/search
Postman Collection Item JSON
{
"name": "Search Users",
"request": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json"
}
],
"url": {
"raw": "{{baseUrl}}/api/v2/users/search?query=<string>&external_id=<string>",
"host": [
"{{baseUrl}}"
],
"path": [
"api",
"v2",
"users",
"search"
],
"query": [
{
"key": "query",
"value": "<string>",
"description": "The `query` parameter supports the Zendesk search syntax for more advanced\nuser searches. It can specify a partial or full value of any\nuser property, including name, email address, notes, or phone. Example:\n`query=\"jdoe\"`.\nSee the [Search API](/api-reference/ticketing/ticket-management/search/).\n"
},
{
"key": "external_id",
"value": "<string>",
"description": "The `external_id` parameter does not support the search syntax. It only accepts ids.\n"
}
]
},
"description": "Returns an array of users who meet the search criteria.\n\n#### Pagination\n\n* Offset pagination only\n\nSee [Using Offset Pagination](/api-reference/ticketing/introduction/#using-offset-pagination).\n\n#### Allowed For\n\n* Admins, Agents and Light Agents\n"
},
"response": [
{
"name": "Success response",
"originalRequest": {
"method": "GET",
"header": [
{
"description": "Added as a part of security scheme: basic",
"key": "Authorization",
"value": "Basic <credentials>"
}
],
"url": {
"raw": "{{baseUrl}}/api/v2/users/search?query=<string>&external_id=<string>",
"host": [
"{{baseUrl}}"
],
"path": [
"api",
"v2",
"users",
"search"
],
"query": [
{
"key": "query",
"value": "<string>",
"description": "The `query` parameter supports the Zendesk search syntax for more advanced\nuser searches. It can specify a partial or full value of any\nuser property, including name, email address, notes, or phone. Example:\n`query=\"jdoe\"`.\nSee the [Search API](/api-reference/ticketing/ticket-management/search/).\n"
},
{
"key": "external_id",
"value": "<string>",
"description": "The `external_id` parameter does not support the search syntax. It only accepts ids.\n"
}
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"cookie": [
],
"body": "{\n \"users\": [\n {\n \"name\": \"<string>\",\n \"active\": \"<boolean>\",\n \"alias\": \"<string>\",\n \"chat_only\": \"<boolean>\",\n \"created_at\": \"<string>\",\n \"custom_role_id\": \"<integer>\",\n \"default_group_id\": \"<integer>\",\n \"details\": \"<string>\",\n \"email\": \"<string>\",\n \"external_id\": \"<string>\",\n \"iana_time_zone\": \"<string>\",\n \"id\": \"<integer>\",\n \"last_login_at\": \"<string>\",\n \"locale\": \"<string>\",\n \"locale_id\": \"<integer>\",\n \"moderator\": \"<boolean>\",\n \"notes\": \"<string>\",\n \"only_private_comments\": \"<boolean>\",\n \"organization_id\": \"<integer>\",\n \"phone\": \"<string>\",\n \"photo\": {\n \"in1f\": false,\n \"cillumb5\": true\n },\n \"remote_photo_url\": \"<string>\",\n \"report_csv\": \"<boolean>\",\n \"restricted_agent\": \"<boolean>\",\n \"role\": \"<string>\",\n \"role_type\": \"<integer>\",\n \"shared\": \"<boolean>\",\n \"shared_agent\": \"<boolean>\",\n \"shared_phone_number\": \"<boolean>\",\n \"signature\": \"<string>\",\n \"suspended\": \"<boolean>\",\n \"tags\": \"<array>\",\n \"ticket_restriction\": \"<string>\",\n \"time_zone\": \"<string>\",\n \"two_factor_auth_enabled\": \"<boolean>\",\n \"updated_at\": \"<string>\",\n \"url\": \"<string>\",\n \"user_fields\": {\n \"nisi_e\": \"commodo exercitation consequat\"\n },\n \"verified\": \"<boolean>\"\n },\n {\n \"name\": \"<string>\",\n \"active\": \"<boolean>\",\n \"alias\": \"<string>\",\n \"chat_only\": \"<boolean>\",\n \"created_at\": \"<string>\",\n \"custom_role_id\": \"<integer>\",\n \"default_group_id\": \"<integer>\",\n \"details\": \"<string>\",\n \"email\": \"<string>\",\n \"external_id\": \"<string>\",\n \"iana_time_zone\": \"<string>\",\n \"id\": \"<integer>\",\n \"last_login_at\": \"<string>\",\n \"locale\": \"<string>\",\n \"locale_id\": \"<integer>\",\n \"moderator\": \"<boolean>\",\n \"notes\": \"<string>\",\n \"only_private_comments\": \"<boolean>\",\n \"organization_id\": \"<integer>\",\n \"phone\": \"<string>\",\n \"photo\": {\n \"ut69\": true,\n \"magna_4\": -92520384\n },\n \"remote_photo_url\": \"<string>\",\n \"report_csv\": \"<boolean>\",\n \"restricted_agent\": \"<boolean>\",\n \"role\": \"<string>\",\n \"role_type\": \"<integer>\",\n \"shared\": \"<boolean>\",\n \"shared_agent\": \"<boolean>\",\n \"shared_phone_number\": \"<boolean>\",\n \"signature\": \"<string>\",\n \"suspended\": \"<boolean>\",\n \"tags\": \"<array>\",\n \"ticket_restriction\": \"<string>\",\n \"time_zone\": \"<string>\",\n \"two_factor_auth_enabled\": \"<boolean>\",\n \"updated_at\": \"<string>\",\n \"url\": \"<string>\",\n \"user_fields\": {\n \"Loremcc\": 52379422,\n \"dolore7\": true,\n \"pariaturf\": \"magna consectet\"\n },\n \"verified\": \"<boolean>\"\n }\n ]\n}"
}
]
}