Filters & dates
Date range
Default behaviour
When no dates are specified, the API automatically queries the last 3 days. If you need data outside that period, specify the range explicitly.
Date parameters
| Parameter | Format | Description |
|---|---|---|
start_date |
YYYY-MM-DD |
Start date (inclusive) |
end_date |
YYYY-MM-DD |
End date (inclusive) |
# Search runs from the past week
curl "http://<host>:<port>/api/v1/dags/my-dag/runs?start_date=2026-04-28&end_date=2026-05-05" \
-H "Authorization: Bearer <token>"
Range limit
The run search endpoint accepts a maximum range of 7 days per query. For longer ranges, split the search into intervals.
Log levels
| Value | Description |
|---|---|
DEBUG |
Detailed debug information |
INFO |
Normal execution flow events |
WARNING |
Unexpected but non-critical situations |
ERROR |
Errors that prevent a specific operation |
CRITICAL |
Severe errors that affect the system |
Values are case-sensitive: always use uppercase.
# Only error logs for a phase
curl "http://<host>:<port>/api/v1/dags/my-dag/runs/2026-05-01/run-id/phases/extract/logs?level=ERROR" \
-H "Authorization: Bearer <token>"
Text search
The keyword parameter filters by message content. The search is case-insensitive and finds partial matches.
curl "http://<host>:<port>/api/v1/dags/my-dag/runs/2026-05-01/run-id/phases/extract/logs?keyword=timeout" \
-H "Authorization: Bearer <token>"
Combined filters
You can combine level and keyword in the same query: