Filtering submissions and results
Every query parameter you can pass to narrow what comes back.
Both the submissions list and the results list accept query parameters to narrow the response. All filters combine with AND. Passing the same filter twice keeps the last value.
Using the Python SDK?
client.submissions.list(...) and client.results.list(...) accept the same filters as keyword arguments. For "every row across every page," reach for client.submissions.iter_all(...). See Submissions.
Submissions list¶
| Parameter | Type / values | Effect |
|---|---|---|
status |
csv of queued,running,succeeded,failed,cancelled |
Match any of the listed statuses. |
source |
api or web |
Where the submission was created. |
submission_type |
csv of submission type slugs | Filter by quick-form type or new. |
visibility |
private,public,invite_only |
Match the share state. |
created_after |
ISO8601 timestamp | Only submissions created at or after this time. |
created_before |
ISO8601 timestamp | Only submissions created at or before this time. |
parent_submission_id |
id | Only continues / re-executions of this submission. |
name_contains |
string, max 100 chars | Case-insensitive substring match on the name. |
ordering |
created_at, -created_at, name, -name, status |
Sort order. Default -created_at. |
Worked example: failed runs from yesterday¶
curl -H "Authorization: Bearer $VILVIK_KEY" \
"https://beta.vilvik.com/api/v1/submissions/?status=failed&created_after=2026-05-09T00:00:00Z&created_before=2026-05-10T00:00:00Z"
Worked example: every continue of a specific submission¶
curl -H "Authorization: Bearer $VILVIK_KEY" \
"https://beta.vilvik.com/api/v1/submissions/?parent_submission_id=abcDEF123456"
Results list¶
| Parameter | Type / values | Effect |
|---|---|---|
submission_id |
id | Only results for this submission. |
is_shared |
true or false |
Filter by share state. |
min_fitness |
float | Best-solution fitness greater or equal to. |
max_fitness |
float | Best-solution fitness less or equal to. |
created_after |
ISO8601 timestamp | Only results created at or after this time. |
created_before |
ISO8601 timestamp | Only results created at or before this time. |
ordering |
created_at, -created_at, best_solution_fitness, -best_solution_fitness |
Sort. Default -created_at. |
Worked example: top results above a fitness threshold¶
curl -H "Authorization: Bearer $VILVIK_KEY" \
"https://beta.vilvik.com/api/v1/results/?min_fitness=10&ordering=-best_solution_fitness&page_size=10"
Pagination plays nicely with filters¶
Cursor pagination works on top of any filter combination. The next URL carries the same filters plus the cursor, so you can iterate without rebuilding the query.
Bad input¶
A malformed value (non-numeric min_fitness, badly formatted date, unknown status) returns 400 invalid_parameter with the parameter name in the error body. See Errors.