Skip to content
Speccy

The run report (SDD §13.1): stage timings, reader diversity, and findings by category.

GET
/runs/{runId}/report
curl --request GET \
  --url https://example.com/api/v1/runs/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/report

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters”
runId
required
string format: uuid

Responses

Section titled “ Responses ”

200

Section titled “200”

The report.

Media typeapplication/json
object
stages
required
Array<object>
object
stage
required
string
started_at
required
string format: date-time
finished_at
string format: date-time
readers

How many readers answered, and how many distinct models served them (REQ-046). Models are not named (DEC-013).

object
readers
required
integer
distinct_models
required
integer
low
required
boolean
categories
required

Open findings by radar category (SDD §8.7), in radar order.

Array<object>
object
category
required
string
score
integer
must
required
integer
should
required
integer
info
required
integer
Examplegenerated
{
  "stages": [
    {
      "stage": "example",
      "started_at": "2026-04-15T12:00:00Z",
      "finished_at": "2026-04-15T12:00:00Z"
    }
  ],
  "readers": {
    "readers": 1,
    "distinct_models": 1,
    "low": true
  },
  "categories": [
    {
      "category": "example",
      "score": 1,
      "must": 1,
      "should": 1,
      "info": 1
    }
  ]
}

default

Section titled “default”

An error.

Media typeapplication/problem+json

RFC 9457 problem details with a stable code.

object
type
required
string
title
required
string
status
required
integer
detail
string
instance
string
code
required

A stable machine-readable error code.

string
Examplegenerated
{
  "type": "example",
  "title": "example",
  "status": 1,
  "detail": "example",
  "instance": "example",
  "code": "example"
}