Get an evaluation

GET /api/v1/evaluations/{id}

Get an evaluation

cURL

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

200

{
  "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
}

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.

Path Parameters

id · string · required

Response

200

application/json

Evaluation data.

id · string · required

Pattern: ^(run|cmpj)_

kind · string · required

Legacy: alpamayo.openloop for the default model or a workspace alias of it, policy.openloop for every other model (before API version 2026-10-24: the lane it ran on, the default model's family lane or policy.openloop). Name the model by model.modelVersionId.

status · enum<string> · required

Available options: queued, dispatching, dispatch_unknown, running, cancelling, succeeded, partial, failed, cancelled

model · object · required

What it ran: the identity block (ModelIdentity); an evaluation from before cloud runs may lack modelVersionId, name, checkpointDigest, aliasOf and owner.

Show child attributes

params · object · required

The runner's job parameters (its instants, render source and sampling).

Show child attributes

scored · boolean | null · required

result · object | null · required

Show child attributes

idempotencyKey · string | null

Caller-supplied job identity; qualification namespaces are excluded from evaluation suites.

workspaceId · string

The workspace it ran in; absent on an evaluation published to every workspace (published).

published · enum<boolean>

An evaluation SimForge published to every workspace (GET /api/v1/evaluations?published=true): read-only, without its workspace, origin, submitter, estimate or cost.

Available options: true

origin · enum<string>

Where it was launched from: Studio (browser), the desktop app, the simforge CLI (cli) or an API key (api).

Available options: browser, desktop, cli, api

modelParams · object

The model's parameters it runs with, by name, defaults filled in (what params sent, else each one's default).

Show child attributes

customParams · boolean

True when a parameter whose comparability is custom (a sampling setting, a navigation instruction) was off its default: compare it only with runs of the same params.

estimateCents · object

Show child attributes

reservedCents · number

settledCents · number | null

{key} · any