Docs

Home All sections Swagger

Results endpoint

List and fetch results from finished submissions.

Last updated June 3, 2026

A result is what a submission produced. One submission can have more than one result if you re-executed or continued it. The base path is https://beta.vilvik.com/api/v1/results/.

Using the Python SDK?

Every operation on this page is available on client.results. See Results. For "wait until the run finishes" call client.results.wait_for(submission_id).

List results

GET /api/v1/results/?submission_id=<id>&page_size=20

submission_id filters to a single submission. Without it, you get every result you own, ordered by creation time (newest first).

curl -H "Authorization: Bearer $VILVIK_KEY" \
     "https://beta.vilvik.com/api/v1/results/?submission_id=abcDEF123456"

{
  "results": [
    {
      "id": "JKLmnop789",
      "submission_id": "abcDEF123456",
      "name": "smoke test",
      "is_shared": false,
      "best_solution_fitness": 4.812,
      "generations_completed": 100,
      "created_at": "2026-05-01T12:35:21Z"
    }
  ],
  "next": null,
  "previous": null
}

More filters (date range, fitness range, shared flag, ordering) are in Filtering submissions and results.

Required scope: results:read.

SDK equivalent: client.results.list(submission_id=...). See Results.

Fetch a single result

GET /api/v1/results/<id>

Returns the full result row, including the best solution genes, the fitness history, and links to the downloadable files.

Required scope: results:read.

SDK equivalent: client.results.get(id). See Results.

Updating a result

You can rename a result or change its is_shared flag with a PATCH:

PATCH /api/v1/results/<id>
Content-Type: application/json

{
  "name": "renamed result",
  "is_shared": true
}

Required scope: results:write.

SDK equivalent: client.results.update(id, name=..., is_shared=...). See Results.

Deleting a result

DELETE /api/v1/results/<id>

Removes the result. The response is 204 No Content. The submission it came from is untouched.

curl -X DELETE https://beta.vilvik.com/api/v1/results/JKLmnop789 \
  -H "Authorization: Bearer $VILVIK_KEY"

Required scope: results:write.

SDK equivalent: client.results.delete(id). See Results.

Thanks for the feedback!