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
Key | Datatype | Required | Description |
---|---|---|---|
start_time | string | (Required) The time to start the incremental export from |
HEADERS
Key | Datatype | Required | Description |
---|---|---|---|
Accept | string |
RESPONSES
status: OK
{"count":2,"end_of_stream":true,"end_time":1390362485,"next_page":"https://{subdomain}.zendesk.com/api/v2/incremental/tickets.json?per_page=3\u0026start_time=1390362485","tickets":[{"assignee_id":235323,"collaborator_ids":[35334,234],"created_at":"2009-07-20T22:55:29Z","custom_fields":[{"id":27642,"value":"745"},{"id":27648,"value":"yes"}],"description":"The fire is very colorful.","due_at":null,"external_id":"ahg35h3jh","follower_ids":[35334,234],"group_id":98738,"has_incidents":false,"id":35436,"organization_id":509974,"priority":"high","problem_id":9873764,"raw_subject":"{{dc.printer_on_fire}}","recipient":"support@company.com","requester_id":20978392,"satisfaction_rating":{"comment":"Great support!","id":1234,"score":"good"},"sharing_agreement_ids":[84432],"status":"open","subject":"Help, my printer is on fire!","submitter_id":76872,"tags":["enterprise","other_tag"],"type":"incident","updated_at":"2011-05-05T10:38:52Z","url":"https://company.zendesk.com/api/v2/tickets/35436.json","via":{"channel":"web"}}]}