Monitor Books

Polling For Completion

In some scenarios, it may be necessary to wait for a Book to reach a certain status before you can perform a certain action.

📘

For instance, every Document in a Book must achieve VERIFICATION_COMPLETE status before you can request analytics for the Book. To check if verification status is complete, poll the Book status endpoint.

Receive notification about document completion

Using webhooks to receive document completion notifications

Use webhooks to receive reliable notifications about document completion.

Using polling to query document completion

If setting up a publicly exposed endpoint is not an option, you can poll specific status query endpoints.

Polling checks for an expected condition by calling a particular query endpoint in a loop.
Since the status of endpoints does not change often, invoking the same query endpoint repeatedly is likely to give the same result for most invocations.

A more efficient approach is to poll in larger intervals, preferably with a back-off strategy for error conditions. To view more details about polling strategies, view Retry strategies.


Did this page help you?