List Suspended Tickets

GET {{baseUrl}}/api/v2/suspended_tickets?sort_by=<string>&sort_order=<string>

Allowed For

  • Unrestricted agents

Sorting

You can sort the tickets with the sort_by and sort_order query string parameters.

Request Params

KeyDatatypeRequiredDescription
sort_bystringThe field to sort the ticket by, being one of author_email, cause, created_at, or subject.
sort_orderstringThe order in which to sort the suspended tickets. This can take value asc or desc.

HEADERS

KeyDatatypeRequiredDescription
Acceptstring

RESPONSES

status: OK

{&quot;suspended_tickets&quot;:[{&quot;attachments&quot;:[],&quot;author&quot;:{&quot;email&quot;:&quot;styx@example.com&quot;,&quot;id&quot;:1,&quot;name&quot;:&quot;Mr. Roboto&quot;},&quot;brand_id&quot;:123,&quot;cause&quot;:&quot;Detected as spam&quot;,&quot;cause_id&quot;:0,&quot;content&quot;:&quot;Out Of Office Reply&quot;,&quot;created_at&quot;:&quot;2009-07-20T22:55:29Z&quot;,&quot;error_messages&quot;:null,&quot;id&quot;:435,&quot;message_id&quot;:&quot;Spambot@spam.co.evil&quot;,&quot;recipient&quot;:&quot;john@example.com&quot;,&quot;subject&quot;:&quot;Help, my printer is on fire!&quot;,&quot;ticket_id&quot;:67321,&quot;updated_at&quot;:&quot;2011-05-05T10:38:52Z&quot;,&quot;url&quot;:&quot;https://example.zendesk.com/api/v2/tickets/35436.json&quot;,&quot;via&quot;:{&quot;channel&quot;:&quot;email&quot;,&quot;source&quot;:{&quot;from&quot;:{&quot;address&quot;:&quot;totallylegit@emailaddress.com&quot;,&quot;name&quot;:&quot;TotallyLegit&quot;},&quot;rel&quot;:null,&quot;to&quot;:{&quot;address&quot;:&quot;support@example.zendesk.com&quot;,&quot;name&quot;:&quot;Example Account&quot;}}}},{&quot;attachments&quot;:[],&quot;author&quot;:{&quot;email&quot;:&quot;styx@example.com&quot;,&quot;id&quot;:1,&quot;name&quot;:&quot;Mr. Roboto&quot;},&quot;brand_id&quot;:123,&quot;cause&quot;:&quot;Automated response mail&quot;,&quot;cause_id&quot;:0,&quot;content&quot;:&quot;Out Of Office Reply&quot;,&quot;created_at&quot;:&quot;2009-07-20T22:55:29Z&quot;,&quot;error_messages&quot;:null,&quot;id&quot;:207623,&quot;message_id&quot;:&quot;Spambot@spam.co.evil&quot;,&quot;recipient&quot;:&quot;john@example.com&quot;,&quot;subject&quot;:&quot;Not just anybody!&quot;,&quot;ticket_id&quot;:67321,&quot;updated_at&quot;:&quot;2011-05-05T10:38:52Z&quot;,&quot;url&quot;:&quot;https://example.zendesk.com/api/v2/tickets/35436.json&quot;,&quot;via&quot;:{&quot;channel&quot;:&quot;email&quot;,&quot;source&quot;:{&quot;from&quot;:{&quot;address&quot;:&quot;totallylegit@emailaddress.com&quot;,&quot;name&quot;:&quot;TotallyLegit&quot;},&quot;rel&quot;:null,&quot;to&quot;:{&quot;address&quot;:&quot;support@example.zendesk.com&quot;,&quot;name&quot;:&quot;Example Account&quot;}}}}]}