Get content run

Returns status and optional result payload for one direct Content Intelligence run.

Endpoint

GET /v1/content-intelligence/runs/{run_id}

Authentication

Header	Required	Value
`Authorization`	Yes	`Bearer sw_api_live_...`

Required scope:

runs:read

Path Parameters

Parameter	Type	Description
`run_id`	string	Content Intelligence run UUID.

Query Parameters

Parameter	Type	Required	Description
`include_result`	boolean	No	Include `ca_result`. Defaults to `false`.

This endpoint primarily reads direct Content Intelligence runs. For compatibility it also accepts an owned saved Content Intelligence run ID, but that fallback returns compact status metadata rather than ca_result; use the Sleepwalker app for the full saved-test report.

Example Request

curl -s "https://api.sleepwalker.ai/v1/content-intelligence/runs/414cee1a-0000-0000-0000-000000000000?include_result=true" \
  -H "Authorization: Bearer sw_api_live_..."

The same request in Python and JavaScript:

import requests

run_id = "414cee1a-0000-0000-0000-000000000000"
resp = requests.get(
    f"https://api.sleepwalker.ai/v1/content-intelligence/runs/{run_id}",
    headers={"Authorization": "Bearer sw_api_live_..."},
    params={"include_result": "true"},
)
resp.raise_for_status()
print(resp.json())

const runId = "414cee1a-0000-0000-0000-000000000000";
const resp = await fetch(
  `https://api.sleepwalker.ai/v1/content-intelligence/runs/${runId}?include_result=true`,
  { headers: { Authorization: "Bearer sw_api_live_..." } },
);
const data = await resp.json();
console.log(data);

Response

{
  "run_id": "414cee1a-...",
  "action_decision_id": "act_...",
  "test_id": null,
  "status": "completed",
  "source": "api",
  "created_at": "2026-06-10T12:30:00Z",
  "started_at": "2026-06-10T12:30:04Z",
  "completed_at": "2026-06-10T12:30:38Z",
  "url": "https://www.sleepwalker.ai",
  "language": "en",
  "country": "US",
  "analysis_depth": "score",
  "overall_score": 76,
  "overall_band": "Good",
  "estimated_credits": "3.00",
  "settled_credits": "3.00",
  "explanation": "Run completed.",
  "ca_result": {
    "overall_score": 76,
    "overall_band": "Good",
    "top_recommendations": []
  }
}

Polling Pattern

create run -> queued
poll status -> running
poll status -> completed
fetch include_result=true when terminal

Errors

Status	Meaning
`401`	Missing or invalid API key.
`403`	API key is missing `runs:read`, or this action is unavailable.
`404`	Run was not found or does not belong to the authenticated user.
`422`	`include_result` has the wrong type.

API-key rate limits and temporary storage errors are documented in Errors.