Replay VisionReplay Vision statistics

Replay Vision statistics

Agency-only UTC zero-filled completed_at daily activity (default last 30 days, max90); independent current created_at month scan ceilings and flat scanner counts including zero-use scanners. Reported known BYOK spend excludes decision-model cost. scoutStats exposes separate range/current UTC month totals and per-Scout rows for all RUN attempts, including failed/cancelled/repair costs and reported/unreported call coverage, without a 1,000-row aggregate cap. Label Reported spend on scout attempts; never count against scan quota. Covers current scanners only: deleting a scanner removes its scan and Scout spend (including failed attempts) from totals.

curl -X GET "https://mythic-analytics.gulp.workers.dev/client/v1/replay-vision/stats?location_id=example_string&scanner_id=123e4567-e89b-12d3-a456-426614174000&date_from=2024-12-25&date_to=2024-12-25" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
{
  "success": true,
  "data": {
    "scoutStats": {
      "spend_label": "Reported spend on scout attempts",
      "range": {
        "date_from": "2024-12-25",
        "date_to": "2024-12-25",
        "totals": {
          "runs": 42,
          "pending": 42,
          "running": 42,
          "succeeded": 42,
          "failed": 42,
          "cancelled": 42,
          "provider_calls": 123,
          "reported_cost_calls": 42,
          "unreported_cost_calls": 42,
          "input_tokens": 42,
          "output_tokens": 42,
          "total_tokens": 42,
          "cost_usd": 3.14
        },
        "scouts": [
          {
            "runs": 42,
            "pending": 42,
            "running": 42,
            "succeeded": 42,
            "failed": 42,
            "cancelled": 42,
            "provider_calls": 123,
            "reported_cost_calls": 42,
            "unreported_cost_calls": 42,
            "input_tokens": 42,
            "output_tokens": 42,
            "total_tokens": 42,
            "cost_usd": 3.14,
            "scout_id": "123e4567-e89b-12d3-a456-426614174000",
            "scout_name": "John Doe",
            "scanner_id": "123e4567-e89b-12d3-a456-426614174000",
            "scanner_name": "John Doe",
            "scanner_type": "monitor",
            "location_id": "example_string",
            "location_name": "John Doe"
          }
        ]
      },
      "month": {
        "start": "2024-12-25T10:00:00Z",
        "resets_at": "2024-12-25T10:00:00Z",
        "totals": {
          "runs": 42,
          "pending": 42,
          "running": 42,
          "succeeded": 42,
          "failed": 42,
          "cancelled": 42,
          "provider_calls": 123,
          "reported_cost_calls": 42,
          "unreported_cost_calls": 42,
          "input_tokens": 42,
          "output_tokens": 42,
          "total_tokens": 42,
          "cost_usd": 3.14
        },
        "scouts": [
          {
            "runs": 42,
            "pending": 42,
            "running": 42,
            "succeeded": 42,
            "failed": 42,
            "cancelled": 42,
            "provider_calls": 123,
            "reported_cost_calls": 42,
            "unreported_cost_calls": 42,
            "input_tokens": 42,
            "output_tokens": 42,
            "total_tokens": 42,
            "cost_usd": 3.14,
            "scout_id": "123e4567-e89b-12d3-a456-426614174000",
            "scout_name": "John Doe",
            "scanner_id": "123e4567-e89b-12d3-a456-426614174000",
            "scanner_name": "John Doe",
            "scanner_type": "monitor",
            "location_id": "example_string",
            "location_name": "John Doe"
          }
        ]
      }
    },
    "timezone": "UTC",
    "date_from": "2024-12-25",
    "date_to": "2024-12-25",
    "spend_label": "Reported spend on completed scans",
    "daily": [
      {
        "date": "2024-12-25",
        "observations": 42,
        "pending": 42,
        "running": 42,
        "queued": 42,
        "succeeded": 42,
        "failed": 42,
        "ineligible": 42,
        "counted_against_limit": 10,
        "decision_agreed": 42,
        "decision_disagreed": 42,
        "cost_reported_count": 10,
        "cost_unreported_count": 10,
        "known_cost_usd": 3.14
      }
    ],
    "month": {
      "start": "2024-12-25T10:00:00Z",
      "resets_at": "2024-12-25T10:00:00Z",
      "scan_limit_total": 42,
      "observations": 42,
      "pending": 42,
      "running": 42,
      "queued": 42,
      "succeeded": 42,
      "failed": 42,
      "ineligible": 42,
      "counted_against_limit": 10,
      "decision_agreed": 42,
      "decision_disagreed": 42,
      "cost_reported_count": 10,
      "cost_unreported_count": 10,
      "known_cost_usd": 3.14
    },
    "scanners": [
      {
        "scanner_id": "123e4567-e89b-12d3-a456-426614174000",
        "location_id": "example_string",
        "name": "John Doe",
        "type": "example_string",
        "enabled": true,
        "monthly_scan_limit": 42,
        "observations": 42,
        "pending": 42,
        "running": 42,
        "queued": 42,
        "succeeded": 42,
        "failed": 42,
        "ineligible": 42,
        "counted_against_limit": 10,
        "decision_agreed": 42,
        "decision_disagreed": 42,
        "cost_reported_count": 10,
        "cost_unreported_count": 10,
        "known_cost_usd": 3.14,
        "totals": {},
        "this_month": {}
      }
    ],
    "totals": {},
    "this_month": {},
    "scanner_counts": {}
  }
}
GET
/client/v1/replay-vision/stats
GET
Base URLstring

Target server for requests. Edit to use your own host.

Bearer Token
Bearer Tokenstring
Required

Agency key (ak_) only; a location secret key (sk_) gets 403 agency_required. Agency-wide scoped keys (mcp_) need replay_vision:read or replay_vision:write.

Agency key (ak_) only; a location secret key (sk_) gets 403 agency_required. Agency-wide scoped keys (mcp_) need replay_vision:read or replay_vision:write.
query
location_idstring

Optional currently linked client; omit for agency-wide roster.

query
date_fromstring

Inclusive UTC YYYY-MM-DD lower bound. Observations/reports: created_at, either bound allowed without stats cap. Stats: completed_at, max90 inclusive days; omitted from defaults to29 days before to, omitted to defaults today.

Format: date
query
date_tostring
Format: date
Request Preview
Response

Response will appear here after sending the request

Authentication

header
Authorizationstring
Required

Bearer token. Agency key (ak_) only; a location secret key (sk_) gets 403 agency_required. Agency-wide scoped keys (mcp_) need replay_vision:read or replay_vision:write.

Query Parameters

location_idstring

Optional currently linked client; omit for agency-wide roster.

date_fromstring

Inclusive UTC YYYY-MM-DD lower bound. Observations/reports: created_at, either bound allowed without stats cap. Stats: completed_at, max90 inclusive days; omitted from defaults to29 days before to, omitted to defaults today.

Responses

successboolean
dataobject