Skip to main content
Every query reports a status that reflects where it is in its lifecycle. The status starts at PENDING when you create a query and ends at PROCESSED when the answer is ready. Failures and retries move it through intermediate states along the way. Poll the get query endpoint and read status to track progress.

​
State diagram

​
States

​
Transitions

Each arrow in the diagram is an allowed transition. Any status change that is not in the diagram is rejected, so a query can only move between valid states.
  • A query moves from PENDING to PROCESSING when the workflow starts execution.
  • The complete transition moves from PROCESSING to PROCESSED when the workflow produces an answer.
  • A fail transition can happen from any state (workflow error or late failure).
  • A retry from FAILED moves the query back to PENDING to restart the workflow.
For the API calls that work with queries, see Working with queries.