Search tickets and contacts
Searches tickets and contacts at once by name, number, email or reference, returning only what the key's person may see. q is required, and category, outcome, status, owner and limit narrow the ticket results.
Requires: desk.read scope, Converse or Contacts licence.
Authorization
bearerAuth A SautiDesk API key. An owner or admin makes it under Settings in SautiDesk for a named person and picks the scopes. The key is shown once. Send it as Authorization: Bearer <key>. It acts as that person and as nobody else.
In: header
Query Parameters
The words to look for.
Only tickets in this category, by name.
Only tickets with this outcome, by name.
Only tickets with this status: open or resolved.
Only tickets owned by this person: their id (a UUID).
next_cursor from the previous page. Leave it out for the first page.
Page size: 100 by default, 100 at most.
Response
OK
Example
{ "data": [ { "kind": "billing", "contact_id": "e370603e-5791-443e-9fb1-26dedb014cd9", "contact_name": "Amina Wanjiru", "contact_number": "+254712345678", "contact_email": "amina@example.com", "ticket_ref": "TCK-4471", "ticket_subject": "Order 1182 has not arrived", "status": "open", "category": "billing", "outcome": "billing", "snippet": "Hi Amina, your order has shipped.", "when": "2026-10-14T08:30:00Z", "activity_id": "0d6c4f09-7095-4291-9bdb-50991c39602c", "author_kind": "agent", "author_name": "Wanjiku Mwangi", "author_user_id": "cacbaaf9-2b98-46a1-9b0e-04f92c823408", "author_note": false } ], "next_cursor": "eyJvIjoyNX0", "has_more": false, "capped": false}datarequiredobject[]kindrequiredstringWhat kind it is.contact_idrequiredstring (uuid)The id of the contact the task is about.contact_namerequiredstringcontact_numberstringcontact_emailstringticket_refstringticket_subjectstringstatusstringThe status to set.categorystringThe name of the category.outcomestringHow it ended: the name or id of one of your outcomes.snippetstringwhenstring (date-time) | nullactivity_idstringThe id of the message on the ticket to forward.author_kindstringauthor_namestringauthor_user_idstringauthor_notebooleannext_cursorrequiredstring | nullhas_morerequiredbooleancappedrequiredbooleancurl -X GET "https://api.sautidesk.com/v1/desk/search?q=string"