Autocomplete Organizations

GET {{baseUrl}}/api/v2/organizations/autocomplete?name=<string>&field_id=<string>&source=<string>

Returns an array of organizations whose name starts with the value specified in the name parameter.

Pagination

  • Offset pagination only

See Using Offset Pagination.

Allowed For

  • Agents

Request Params

KeyDatatypeRequiredDescription
namestring(Required) A substring of an organization to search for
field_idstringThe id of a lookup relationship field. The type of field is determined
by the source param
sourcestringIf a field_id is provided, this specifies the type of the field.
For example, if the field is on a "zen:user", it references a field on a user

HEADERS

KeyDatatypeRequiredDescription
Acceptstring

RESPONSES

status: OK

{&quot;count&quot;:2,&quot;next_page&quot;:null,&quot;organizations&quot;:[{&quot;created_at&quot;:&quot;2018-11-14T00:14:52Z&quot;,&quot;details&quot;:&quot;caterpillar =)&quot;,&quot;domain_names&quot;:[&quot;remain.com&quot;],&quot;external_id&quot;:null,&quot;group_id&quot;:1835962,&quot;id&quot;:35436,&quot;name&quot;:&quot;Important Customers&quot;,&quot;notes&quot;:&quot;donkey&quot;,&quot;organization_fields&quot;:{&quot;datepudding&quot;:&quot;2018-11-04T00:00:00+00:00&quot;,&quot;org_field_1&quot;:&quot;happy happy&quot;,&quot;org_field_2&quot;:&quot;teapot_kettle&quot;},&quot;shared_comments&quot;:false,&quot;shared_tickets&quot;:false,&quot;tags&quot;:[&quot;smiley&quot;,&quot;teapot_kettle&quot;],&quot;updated_at&quot;:&quot;2018-11-14T00:54:22Z&quot;,&quot;url&quot;:&quot;https://example.zendesk.com/api/v2/organizations/4112492.json&quot;},{&quot;created_at&quot;:&quot;2017-08-14T20:13:52Z&quot;,&quot;details&quot;:&quot;test&quot;,&quot;domain_names&quot;:[&quot;test.com&quot;],&quot;external_id&quot;:null,&quot;group_id&quot;:null,&quot;id&quot;:20057623,&quot;name&quot;:&quot;Imperial College&quot;,&quot;notes&quot;:&quot;&quot;,&quot;organization_fields&quot;:{&quot;datepudding&quot;:&quot;2018-11-02T00:00:00+00:00&quot;,&quot;org_field_1&quot;:&quot;malarky&quot;,&quot;org_field_2&quot;:&quot;teapot_kettle&quot;},&quot;shared_comments&quot;:false,&quot;shared_tickets&quot;:false,&quot;tags&quot;:[&quot;teapot_kettle&quot;],&quot;updated_at&quot;:&quot;2019-05-16T01:27:46Z&quot;,&quot;url&quot;:&quot;https://example.zendesk.com.com/api/v2/organizations/1873.json&quot;}],&quot;previous_page&quot;:null}