Poll transactions

Poll for new transactions that Stedi has processed.

This endpoint returns details about transactions that Stedi processed after the specified startDateTime.

Transactions 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, a transaction processed at exactly that time would not be included in the results. There is also a fifteen-second window where newly created transactions 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 transactions.

Polling with page tokens

We don’t recommend polling using startDateTime only. Due to the exclusive nature of startDateTime, you could potentially miss a transaction if two transactions 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 transactions. The endpoint always returns a nextPageToken, regardless of whether additional transactions match the request criteria. If the items array is empty, continue using the provided nextPageToken to poll for new transactions. New transactions 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 transaction 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.