When working with Workflow Deployments in production, you’ll often need to filter and retrieve execution data for monitoring, debugging, or analytics purposes. This guide shows you how to use the Workflow execution API endpoints effectively, including how to construct complex filters programmatically.
Vellum provides two key endpoints for working with Workflow execution data:
The filters parameter accepts a JSON string that defines complex filtering conditions. Here’s the basic structure:
Use the ordering parameter to sort execution results. Common ordering options include:
timestamp - Sort by execution timestamp (oldest first)-timestamp - Sort by execution timestamp (newest first)state - Sort by execution state-state - Sort by execution state (reverse order)Once you have an execution ID, you can retrieve detailed information including submitted actuals:
While we recommend using the programmatic approach above, you can also use the Vellum UI to build filters visually and then copy the generated filter structure:

The URL will contain the encoded filter structure that you can decode and use in your API calls:
Here are the most commonly used fields for filtering Workflow executions:
When building filter conditions, you can use these operators: