List visibility runs

Lists direct AI Visibility runs for the authenticated user.

This endpoint lists runs created through API or MCP. Saved Console test history is available through saved-test report endpoints.

Endpoint

GET /v1/visibility/runs

Authentication

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

Required scope:

runs:read

Query Parameters

Parameter	Type	Required	Description
`status`	string	No	Filter by run status.
`limit`	integer	No	Number of runs to return. Clamped between 1 and 100. Defaults to 20.
`starting_after`	string	No	Cursor run ID from the previous page.

Results are sorted by created_at descending.

Example Request

curl -s "https://api.sleepwalker.ai/v1/visibility/runs?limit=20" \
  -H "Authorization: Bearer sw_api_live_..."

The same request in Python and JavaScript:

import requests

resp = requests.get(
    "https://api.sleepwalker.ai/v1/visibility/runs",
    headers={"Authorization": "Bearer sw_api_live_..."},
    params={"limit": 20},
)
resp.raise_for_status()
print(resp.json())

const resp = await fetch("https://api.sleepwalker.ai/v1/visibility/runs?limit=20", {
  headers: { Authorization: "Bearer sw_api_live_..." },
});
const data = await resp.json();
console.log(data);

Response

{
  "runs": [
    {
      "run_id": "6a75b22b-...",
      "status": "completed",
      "source": "api",
      "created_at": "2026-06-10T12:30:00Z",
      "started_at": "2026-06-10T12:30:05Z",
      "completed_at": "2026-06-10T12:31:10Z",
      "url": "https://www.sleepwalker.ai",
      "target_entity": "Sleepwalker",
      "language": "en",
      "country": "US",
      "requested_probe_count": 4,
      "queued_probe_count": 4,
      "running_probe_count": 0,
      "succeeded_probe_count": 4,
      "errored_probe_count": 0,
      "cancelled_probe_count": 0,
      "estimated_credits": "4.00",
      "settled_credits": "4.00",
      "summary": {
        "mention_rate": 50,
        "overall_score": 50,
        "overall_band": "Good",
        "brand_mentions": 2,
        "citation_mentions": 1
      }
    }
  ],
  "limit": 20,
  "has_more": false,
  "next_starting_after": null
}

See Pagination for cursor behavior.

Errors

Status	Meaning
`401`	Missing or invalid API key.
`400`	Invalid cursor.
`403`	API key is missing `runs:read`, or this action is unavailable.
`422`	`limit` has the wrong type.

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