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.

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:

Python

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())

JavaScript

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.