runs

Get run status + summary

Poll this until status is terminal. Completed runs are immutable and served with a cacheable Cache-Control; in-flight runs are no-store.

get/api/v1/runs/{runId}

Request

  • Base URL: https://index365.co
  • URL: https://index365.co/api/v1/runs/{runId}
  • Auth: HTTP bearer

Path parameters

runIdstring uuid required

Run id returned by start_audit or list_runs.

Response

Run envelope.

schemaVersioninteger
product'ai_readiness' | 'marketing_signal' | 'marketing_signal_v2' | 'website_security'
runIdstring uuid
projectIdstring uuid nullable
status'pending' | 'running' | 'completed' | 'failed' | 'failed_auto_credit' | 'refunded'
progressPctinteger
currentStepstring nullable
urlstring
scanModestring nullable
modelstring nullable
costUsdnumber
errorstring nullable
createdAtstring date-time
startedAtstring date-time nullable
completedAtstring date-time nullable
scoreinteger nullable
scoreStatus'unverified' | 'null' nullable

unverified when source-only page evidence needs rendered verification.

band'Weak' | 'Fair' | 'Good' | 'Excellent' | 'null' nullable

Marketing Signal runs only: the band for score.

coverageLinestring

Marketing Signal runs only: what the run graded, as a sentence.

restatedboolean

Marketing Signal runs only: true when this run stored a different headline, which happens on runs scored before the corrected weighting.

restatementNotestring
legacyStoredScoreinteger nullable

Marketing Signal runs only: the headline this run stored. For reconciliation, never for display.

severityCountsobject nullable
findingsTotalinteger nullable
humanUrlstring

Example response

{
  "schemaVersion": 3,
  "coverageLine": "Scored from 21 of 24 applicable checks"
}

Changes

No recorded changes to this operation across all 1 revision of this API.