Get a run result
const url = 'https://api.hyperresearch.ai/v1/runs/example/result';const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url https://api.hyperresearch.ai/v1/runs/example/result \ --header 'Authorization: Bearer <token>'Artifact URLs are short-lived signed Worker download URLs valid for one hour.
Authorizations
Section titled “Authorizations”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters”Responses
Section titled “ Responses ”Result
object
Every page this run tried and did not keep: { url, domain, outcome, reason, detail, rung, at }. reason is a closed enum and is always set — unknown with the raw text in detail when the ladder recorded nothing to classify (E2E8-12). sources is what the run kept; this is the other half, so a reloaded run still explains the gap between pages considered and sources kept (E2E8-02).
The skipped list in one sentence — “30 pages considered, 21 kept; 9 were skipped: …” — written at finish so it survives a reload. Null for a run that finished before the artifact existed.
object
Premium seats only: the model that really answered each promoted seat (planner, section writers, editor), with call counts and every fallback, and the receipt sentence (“Report planned, written and edited by Claude Opus 5.5.”). Null for a run without premium seats.
object
object
object
The model credit the report may show (“Powered by Claude Opus 5.5”), set only when the accepted output of that seat really came from the model: the Light final edit that shipped, or the Deep plan that was used. Null on a fallback, a skipped or rejected edit, or a plan from the standard model. Absent on runs that finished before it existed.
object
Light only: how the final edit ended. rejected and skipped ship the checked report unchanged.
The language the report was written in, as a BCP-47 primary subtag (zh, en, ja, …): the run’s report_language lever when one was set, otherwise the language of the question — the same rule, over the same frozen inputs, the run itself used. Null when it cannot be known (a run admitted before launch packets were stored). Clients label the report (source-list headings, dates) in this language rather than guessing from its text.
Findings a reader should act on before relying on the report, in the order to show them. Empty when there are none. Every other finding stays in verification as information.
object
The receipt check this finding came from, e.g. citation-spot-check.
How many: cited statements shipped uncorrected, chapters, parts of the question, retracted citations.
What count is out of (statements checked, parts of the question), or null when not stated.
For unsupported-statements: whether the check counted cited figures or cited statements.
Chapter titles, question parts or the title of the retracted source. Empty when the receipt does not name them.
The cited statements the checks flagged that ship as written, at most 200. Null when the run kept no per-sentence record of its checks.
object
The sentence as it ships in the report, at most 400 characters.
What the check found: the source says otherwise, does not state it, states part of it, or differs in a detail.
The ids of the sources the sentence cites.
Example
{ "seat_models": { "version": 1, "writer": "phased", "policy": "base", "credit": { "role": "edit" }, "light_edit": "accepted" }, "report_language": "zh", "attention": [ { "kind": "unsupported-statements", "unit": "figures" } ], "flagged_statements": [ { "verdict": "wrong" } ]}Headers
Section titled “Headers”Example
"reads";q=60;w=60The quota policy this request was counted against (draft-ietf-httpapi-ratelimit-headers): "<bucket>";q=<requests>;w=<window seconds>, e.g. "reads";q=60;w=60. Buckets: reads 60/min, status 600/min, creates 10/min, writes 20/min per credential; public 300/min per network on keyless routes.
Example
"reads";r=57;t=41Remaining quota in the current window: "<bucket>";r=<remaining>;t=<seconds until reset>, e.g. "reads";r=57;t=41.
Requests allowed per window in this bucket (legacy form of RateLimit-Policy).
Requests left in this window (legacy form of RateLimit).
Unix time (seconds) when the window resets.
Which bucket counted the request: reads, status, creates, writes or public.
The result has not changed since the ETag the client holds. Sent for settled runs only.
Invalid request
object
object
Example
{ "error": { "type": "invalid_request", "code": "missing_api_key", "request_id": "req_01J9ZQ7V6H0000000000000000" }}Authentication failed
object
object
Example
{ "error": { "type": "invalid_request", "code": "missing_api_key", "request_id": "req_01J9ZQ7V6H0000000000000000" }}Insufficient scope or plan
object
object
Example
{ "error": { "type": "invalid_request", "code": "missing_api_key", "request_id": "req_01J9ZQ7V6H0000000000000000" }}Not found
object
object
Example
{ "error": { "type": "invalid_request", "code": "missing_api_key", "request_id": "req_01J9ZQ7V6H0000000000000000" }}Rate limited or over quota
object
object
Example
{ "error": { "type": "invalid_request", "code": "missing_api_key", "request_id": "req_01J9ZQ7V6H0000000000000000" }}Headers
Section titled “Headers”Seconds to wait before retrying. Always present on a 429.
Example
"reads";q=60;w=60The quota policy this request was counted against (draft-ietf-httpapi-ratelimit-headers): "<bucket>";q=<requests>;w=<window seconds>, e.g. "reads";q=60;w=60. Buckets: reads 60/min, status 600/min, creates 10/min, writes 20/min per credential; public 300/min per network on keyless routes.
Example
"reads";r=57;t=41Remaining quota in the current window: "<bucket>";r=<remaining>;t=<seconds until reset>, e.g. "reads";r=57;t=41.
Requests allowed per window in this bucket (legacy form of RateLimit-Policy).
Requests left in this window (legacy form of RateLimit).
Unix time (seconds) when the window resets.
Which bucket counted the request: reads, status, creates, writes or public.
Internal error
object
object
Example
{ "error": { "type": "invalid_request", "code": "missing_api_key", "request_id": "req_01J9ZQ7V6H0000000000000000" }}