List evaluations

The workspace’s own evaluations, newest first, whichever model ran them; with published=true also those SimForge published to every workspace (read-only, without how SimForge ran them). Each one’s model names the registered version it ran (modelVersionId) and its name; modelVersionId filters by it. Each one’s legacy kind is alpamayo.openloop for the default model or a workspace alias of it and policy.openloop for every other model (API versions before 2026-10-24: the lane it ran on, which ?kind= filters by; from 2026-10-24 kind is refused, 400 validation_failed, param kind).

GET /api/v1/evaluations

List evaluations

cURL

curl --request GET \
  --url https://dev.simforge.ai/api/v1/evaluations \
  --header 'Authorization: Bearer <token>'

200

{
  "data": [
    {
      "id": "<string>",
      "kind": "<string>",
      "status": "queued",
      "model": {
        "family": "<string>",
        "revision": "<string>",
        "quant": "<string>",
        "modelVersionId": "<string>",
        "name": "<string>",
        "checkpointDigest": "<string>",
        "aliasOf": "<string>",
        "owner": "<string>"
      },
      "params": {},
      "scored": true,
      "result": {
        "metrics": {},
        "artifacts": [
          {
            "role": "<string>",
            "artifactId": "<string>",
            "mediaType": "<string>",
            "bytes": 1,
            "sha256": "<string>"
          }
        ]
      },
      "idempotencyKey": "<string>",
      "workspaceId": "<string>",
      "published": true,
      "origin": "browser",
      "modelParams": {},
      "customParams": true,
      "estimateCents": {
        "lowCents": 1,
        "highCents": 1,
        "basis": "measured"
      },
      "reservedCents": 123,
      "settledCents": 123
    }
  ],
  "nextCursor": "<string>"
}

Authorizations

Authorization · string · header · required

A sfc_at_… access token from simforge login, or an sfk_… API key. An operation's security lists the scopes the credential must hold.

Query Parameters

cursor · string

Minimum string length: 1

limit · integer · default: 50

Required range: 1 <= x <= 500

modelVersionId · string

Only evaluations of these models, comma-separated (an offered model's id from GET /api/v1/evaluation-options, or a workspace version), with those of a workspace version that is an alias of one. Default: every model.

Minimum string length: 1

status · string

Only evaluations in these statuses, comma-separated.

Minimum string length: 1

published · enum<string>

true: also the evaluations SimForge published to every workspace (public benchmarks). Without it the list holds only this workspace's evaluations.

Available options: true

Response

200

application/json

Evaluation data.

data · object[] · required

Show child attributes

nextCursor · string | null · required