---
title: "The unified machine record for one observation: subject, grade, findings (top one in full without a licence), capabilities with verification, evidence roots and verifier links"
method: GET
path: "/api/v1/machine-record"
---

# The unified machine record for one observation: subject, grade, findings (top one in full without a licence), capabilities with verification, evidence roots and verifier links

`GET /api/v1/machine-record`

## Request

- Base URL: `https://crawlcheck.io`
- URL: `https://crawlcheck.io/api/v1/machine-record`
- Auth: none required

## Query parameters

- `id` string
- `domain` string
- `format` 'json' | 'otel' | 'openlineage' | 'jsonld'

## Response `200`

MachineRecordV1

- MachineRecordV1: One observation in one shape (GET /api/v1/machine-record, MCP machine_record): subject, observation, findings (top in full without a licence; the rest locked), capabilities with safety class and verification state, evidence roots and verifier links
  - `kind` 'crawlcheck-machine-record', required
  - `version` string, required
  - `subject` object, required
  - `observation` object, required
  - `findings` unknown[], required: each open finding carries trust {freshness, confidence {level, means, basis[]}, contradictions[]}
    - unknown
  - `freshness` object: observed_at, age_hours, latest_report_id, is_latest, newer_scan_exists, last_second_reading_at
  - `fix_impact` object, nullable: With a licence: one line per fix that would change this record, best first (findings and rows it clears, other fixes some rows also need, score and letter after, root causes closed, certificate criteria flipped). Without: {fixes_available, best_single_fix {letter_after, score_after, findings_cleared, rows_cleared}} and no names
  - `score_ledger` object, nullable: score, letter, cap and the points each failing row moves (rows open with a licence); each open finding carries score_effect {points: 0, cap, binding, letter_without_it, says}
  - `confidence` object: counts and ratios plus vantages; no composite number; levels: contested | cross_vantage_confirmed | reproduced | single_reading
  - `contradictions` object: site (the site contradicts itself) and between_networks_open (observers disagree), for findings this caller can open
  - `findings_summary` object, nullable
  - `findings_withheld` string, nullable
  - `capabilities` object, required
  - `evidence` object, required
  - `access` object, required

## Other responses

- `404`: no record

---

[API](https://skmtc.dev/crawlcheck/apis/crawlcheck-api.md) · [All operations](https://skmtc.dev/crawlcheck/apis/crawlcheck-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlcheck/apis/crawlcheck-api/revisions/57acbd6d4489?raw)