> ## Documentation Index
> Fetch the complete documentation index at: https://stedi.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Poll Executions

> Poll for new file executions that Stedi has recently processed.

This endpoint returns file executions that Stedi processed after the specified `startDateTime`.

Executions are ordered from oldest to newest according to the `processedAt` property. This is exclusive of the `startDateTime`. For example, if the provided startDateTime is `2023-08-10T18:00:00Z`, an execution processed at exactly that time would not be included in the results. There is also a fifteen-second window where newly created executions are excluded, meaning Stedi returns results up to fifteen seconds before the time of your request. This functionality accounts for any network latency or clock drift within the systems to ensure you don't miss any executions.

## Polling with page tokens

We **don't** recommend polling using `startDateTime` only. Due to the exclusive nature of `startDateTime`, you could potentially miss an execution if two executions occur at the *exact* same time and are on the edge of a pagination. Instead, you should use `pageToken`.

After the initial request, you can poll again immediately using `pageToken` to continue iterating through the pages of executions. The endpoint always returns a `nextPageToken`, regardless of whether additional executions match the request criteria. If the `items` array is empty, continue using the provided `nextPageToken` to poll for new executions. New executions will be returned when available.

We recommend storing `pageToken` values as part of your polling process. They don't expire, allowing you to start from that point in the execution stream again if you need to catch a system up to date or recover from a failure.

Note that `pageToken` values are unique per request, opaque, and shouldn't be parsed or modified in any way. They are not guaranteed to be in any particular format, and may change in the future.