Incremental Ticket Export, Time Based

GET {{baseUrl}}/api/v2/incremental/tickets?start_time=<integer>

Returns the tickets that changed since the start time. For more information, see Exporting tickets in Using the Incremental Exports API.

This endpoint supports time-based incremental exports. For more information, see Time-based incremental exports in Using the Incremental Exports API. You can also return tickets using cursor-based pagination. See Incremental Ticket Export, Cursor Based.

The results include tickets that were updated by the system. See Excluding system-updated tickets in Using the Incremental Exports API.

The endpoint can return tickets with an updated_at time that's earlier than the start_time time. The reason is that the API compares the start_time with the ticket's generated_timestamp value, not its updated_at value. The updated_at value is updated only if the update generates a ticket event. The generated_timestamp value is updated for all ticket updates, including system updates. If a system update occurs after a ticket event, the unchanged updated_at time will become earlier relative to the updated generated_timestamp time.

Allowed For

  • Admins

Sideloading

See Tickets sideloads. For performance reasons, last_audits sideloads aren't supported.

Request Params

KeyDatatypeRequiredDescription
start_timestring(Required) The time to start the incremental export from

HEADERS

KeyDatatypeRequiredDescription
Acceptstring

RESPONSES

status: OK

{&quot;count&quot;:2,&quot;end_of_stream&quot;:true,&quot;end_time&quot;:1390362485,&quot;next_page&quot;:&quot;https://{subdomain}.zendesk.com/api/v2/incremental/tickets.json?per_page=3\u0026start_time=1390362485&quot;,&quot;tickets&quot;:[{&quot;assignee_id&quot;:235323,&quot;collaborator_ids&quot;:[35334,234],&quot;created_at&quot;:&quot;2009-07-20T22:55:29Z&quot;,&quot;custom_fields&quot;:[{&quot;id&quot;:27642,&quot;value&quot;:&quot;745&quot;},{&quot;id&quot;:27648,&quot;value&quot;:&quot;yes&quot;}],&quot;description&quot;:&quot;The fire is very colorful.&quot;,&quot;due_at&quot;:null,&quot;external_id&quot;:&quot;ahg35h3jh&quot;,&quot;follower_ids&quot;:[35334,234],&quot;group_id&quot;:98738,&quot;has_incidents&quot;:false,&quot;id&quot;:35436,&quot;organization_id&quot;:509974,&quot;priority&quot;:&quot;high&quot;,&quot;problem_id&quot;:9873764,&quot;raw_subject&quot;:&quot;{{dc.printer_on_fire}}&quot;,&quot;recipient&quot;:&quot;support@company.com&quot;,&quot;requester_id&quot;:20978392,&quot;satisfaction_rating&quot;:{&quot;comment&quot;:&quot;Great support!&quot;,&quot;id&quot;:1234,&quot;score&quot;:&quot;good&quot;},&quot;sharing_agreement_ids&quot;:[84432],&quot;status&quot;:&quot;open&quot;,&quot;subject&quot;:&quot;Help, my printer is on fire!&quot;,&quot;submitter_id&quot;:76872,&quot;tags&quot;:[&quot;enterprise&quot;,&quot;other_tag&quot;],&quot;type&quot;:&quot;incident&quot;,&quot;updated_at&quot;:&quot;2011-05-05T10:38:52Z&quot;,&quot;url&quot;:&quot;https://company.zendesk.com/api/v2/tickets/35436.json&quot;,&quot;via&quot;:{&quot;channel&quot;:&quot;web&quot;}}]}