Polling

Polling means your application periodically GETs the dataset metadata and checks the solverStatus field until it reaches SOLVING_COMPLETED, SOLVING_FAILED, or SOLVING_INCOMPLETE.

Use polling only when neither Webhooks nor Server sent events (SSE) are viable, for example, if your application runs in an environment where outbound streaming connections aren’t supported.

The main drawback is that polling creates unnecessary load and introduces latency proportional to your poll interval. If you do poll, use a backoff strategy: start with a short interval and increase it for longer-running solves rather than polling at a fixed rate.

In production, we recommend configuring Webhooks to retrieve the solutions to your submitted datasets from Timefold.

In local development environments, we recommend Server sent events (SSE), however, when server sent events are not possible, you can poll Timefold.