List QR assets and health

Returns paginated code assets, cached destination health, lifecycle and activity flags. With refresh_health="true", it probes destinations and stores refreshed health; this combined operation requires confirmation.

Outcome

Before you start

Verify identity, environment and the intended organization before discovery.
Discover the published analytics:read permission and the target policy.
Select an accessible canonical Auth workspace and set WORKSPACE_ID to its returned id. Workspace binding is separate from input.
Review and confirm the exact unchanged plan before execution. Example identifiers grant no live authority.

Discover the target

topolo whoami --json
topolo workspaces list topolo-quro --json
topolo actions get app_topolo_quro.analytics.assets.list --detail --json

seriesId: Discovered numeric series id used to filter inventory or assets.

Request

GET /openclaw/quro/assets

Inspect parameters and test this action.

Input fields

Field	Required	Meaning
`page`	No	One-based numbered page. Continue while meta.hasMore is true, preserving other filters.
`perPage`	No	Requested page size capped at 100. This is numbered pagination, not a cursor.
`search`	No	Text filter for codes or templates; it does not change stored records.
`tier`	No	Declared basic, standard or premium tier; listing can also accept all where the input enum allows it. This field is not a pricing or entitlement check.
`seriesId`	No	Discovered numeric series id used to filter inventory or assets.
`refresh_health`	No	Literal string false performs a cached read. String true probes destinations and writes refreshed health. This combined action requires confirmation.
`inactivity_days`	No	Non-negative inactivity threshold; compare resulting flags and the effective window.
`window_days`	No	Positive activity window. The response reports its effective date range.
`from`	No	Requested beginning of the analytics/date filter window. Inspect the effective from returned by the handler.
`to`	No	Requested end of the analytics/date filter window. Inspect the effective to returned by the handler.

Worked examples

Actual exported Quro Worker with local Miniflare D1/KV and every committed app/analytics migration. Auth, service tokens, Nexus, destination probes and platform archival are synthetic responses; outbound fetch is sealed. Notifications remain in the local outbox. No live redirect propagation, QR scan, destination health, provider delivery, archival or production erasure is established.

Save reviewed input as payload.json, replacing fixture identifiers through discovery.

topolo actions validate app_topolo_quro.analytics.assets.list --data @payload.json --json
topolo actions plan app_topolo_quro.analytics.assets.list --resource-type workspace --resource-id "$WORKSPACE_ID" --data @payload.json --confirm --json
topolo actions call app_topolo_quro.analytics.assets.list --resource-type workspace --resource-id "$WORKSPACE_ID" --data @payload.json --confirm --detail --json

MCP uses the same reviewed input and separately discovered resource binding:

{
  "tool": "topolo_prepare_action",
  "arguments": {
    "actionId": "app_topolo_quro.analytics.assets.list",
    "input": {
      "search": "premium",
      "tier": "premium",
      "refresh_health": "false",
      "inactivity_days": 0,
      "window_days": 7,
      "from": "2026-10-06",
      "to": "2026-10-06"
    },
    "resourceType": "workspace",
    "resourceId": "ws_quro_fixture",
    "confirm": true
  }
}

{
  "tool": "topolo_call_action",
  "arguments": {
    "actionId": "app_topolo_quro.analytics.assets.list",
    "input": {
      "search": "premium",
      "tier": "premium",
      "refresh_health": "false",
      "inactivity_days": 0,
      "window_days": 7,
      "from": "2026-10-06",
      "to": "2026-10-06"
    },
    "resourceType": "workspace",
    "resourceId": "ws_quro_fixture",
    "confirm": true,
    "detail": true
  }
}

Worked response 1 · HTTP 200 · Cached destination health

Input · payload.json:

{
  "search": "premium",
  "tier": "premium",
  "refresh_health": "false",
  "inactivity_days": 0,
  "window_days": 7,
  "from": "2026-10-06",
  "to": "2026-10-06"
}

Captured SDK response:

{
  "success": true,
  "data": [
    {
      "id": 14,
      "slug": "premium-fixture",
      "tier": "premium",
      "assets": {
        "redirect_url": "https://ol0.me/premium-fixture",
        "png_url": "https://api.ol0.me/qr/premium-fixture.png?v=1",
        "svg_url": "https://api.ol0.me/qr/premium-fixture.svg?v=1"
      },
      "destination": {
        "url": "https://example.com/item/premium",
        "health": {
          "state": "unknown",
          "checked_at": null,
          "http_status": null,
          "error_message": null,
          "response_time_ms": null
        }
      },
      "status": {
        "id": 2,
        "label": "Inactive",
        "effective": "inactive"
      },
      "campaign": null,
      "lifecycle": {
        "created_at": "2026-10-06T11:16:13.017Z",
        "updated_at": "2026-10-06T11:16:13.064Z",
        "valid_from": null,
        "valid_to": null,
        "max_usage": null
      },
      "analytics": {
        "total_scans": 2,
        "scans_in_window": 0,
        "successful_redirects_in_window": 0,
        "invalid_hits_in_window": 0,
        "inactive_hits_in_window": 0,
        "expired_hits_in_window": 0,
        "exhausted_hits_in_window": 0,
        "broken_target_hits_in_window": 0,
        "last_scan_at": null,
        "last_event_at": null
      },
      "flags": {
        "expired": false,
        "exhausted": false,
        "inactive_by_status": true,
        "inactive_by_activity": false,
        "broken_target": false,
        "failing": true
      }
    }
  ],
  "meta": {
    "page": 1,
    "perPage": 50,
    "total": 1,
    "hasMore": false,
    "from": "2026-10-06",
    "to": "2026-10-06",
    "refresh_health": false,
    "inactivity_days": 30
  }
}

HTTP 200. Inspect meta.hasMore and preserve filters. Unknown destination health is not healthy. Asset URLs in the response do not prove the images or redirects are deployed or reachable.

Worked response 2 · HTTP 200 · Cached destination health

Input · payload.json:

{}

Captured SDK response:

{
  "success": true,
  "data": [
    {
      "id": 16,
      "slug": "6df2of7g",
      "tier": "standard",
      "assets": {
        "redirect_url": "https://ol0.me/6df2of7g",
        "png_url": "https://api.ol0.me/qr/6df2of7g.png?v=1",
        "svg_url": "https://api.ol0.me/qr/6df2of7g.svg?v=1"
      },
      "destination": {
        "url": "mailto:reviewed@example.com",
        "health": {
          "state": "unknown",
          "checked_at": null,
          "http_status": null,
          "error_message": null,
          "response_time_ms": null
        }
      },
      "status": {
        "id": 1,
        "label": "Active",
        "effective": "active"
      },
      "campaign": null,
      "lifecycle": {
        "created_at": "2026-10-06T11:16:13.167Z",
        "updated_at": "2026-10-06T11:16:13.197Z",
        "valid_from": null,
        "valid_to": null,
        "max_usage": null
      },
      "analytics": {
        "total_scans": 0,
        "scans_in_window": 0,
        "successful_redirects_in_window": 0,
        "invalid_hits_in_window": 0,
        "inactive_hits_in_window": 0,
        "expired_hits_in_window": 0,
        "exhausted_hits_in_window": 0,
        "broken_target_hits_in_window": 0,
        "last_scan_at": null,
        "last_event_at": null
      },
      "flags": {
        "expired": false,
        "exhausted": false,
        "inactive_by_status": false,
        "inactive_by_activity": false,
        "broken_target": false,
        "failing": false
      }
    },
    {
      "id": 14,
      "slug": "premium-fixture",
      "tier": "premium",
      "assets": {
        "redirect_url": "https://ol0.me/premium-fixture",
        "png_url": "https://api.ol0.me/qr/premium-fixture.png?v=1",
        "svg_url": "https://api.ol0.me/qr/premium-fixture.svg?v=1"
      },
      "destination": {
        "url": "https://example.com/item/premium",
        "health": {
          "state": "unknown",
          "checked_at": null,
          "http_status": null,
          "error_message": null,
          "response_time_ms": null
        }
      },
      "status": {
        "id": 2,
        "label": "Inactive",
        "effective": "inactive"
      },
      "campaign": null,
      "lifecycle": {
        "created_at": "2026-10-06T11:16:13.017Z",
        "updated_at": "2026-10-06T11:16:13.064Z",
        "valid_from": null,
        "valid_to": null,
        "max_usage": null
      },
      "analytics": {
        "total_scans": 2,
        "scans_in_window": 0,
        "successful_redirects_in_window": 0,
        "invalid_hits_in_window": 0,
        "inactive_hits_in_window": 0,
        "expired_hits_in_window": 0,
        "exhausted_hits_in_window": 0,
        "broken_target_hits_in_window": 0,
        "last_scan_at": null,
        "last_event_at": null
      },
      "flags": {
        "expired": false,
        "exhausted": false,
        "inactive_by_status": true,
        "inactive_by_activity": false,
        "broken_target": false,
        "failing": true
      }
    },
    {
      "id": 4,
      "slug": "fixture-collision",
      "tier": "standard",
      "assets": {
        "redirect_url": "https://ol0.me/fixture-collision",
        "png_url": "https://api.ol0.me/qr/fixture-collision.png?v=1",
        "svg_url": "https://api.ol0.me/qr/fixture-collision.svg?v=1"
      },
      "destination": {
        "url": "https://example.com/collision/1",
        "health": {
          "state": "unknown",
          "checked_at": null,
          "http_status": null,
          "error_message": null,
          "response_time_ms": null
        }
      },
      "status": {
        "id": 1,
        "label": "Active",
        "effective": "active"
      },
      "campaign": {
        "id": 1,
        "name": "Fixture campaign",
        "status": "completed"
      },
      "lifecycle": {
        "created_at": "2026-10-06T11:16:12.461Z",
        "updated_at": "2026-10-06T11:16:12.461Z",
        "valid_from": null,
        "valid_to": null,
        "max_usage": null
      },
      "analytics": {
        "total_scans": 0,
        "scans_in_window": 0,
        "successful_redirects_in_window": 0,
        "invalid_hits_in_window": 0,
        "inactive_hits_in_window": 0,
        "expired_hits_in_window": 0,
        "exhausted_hits_in_window": 0,
        "broken_target_hits_in_window": 0,
        "last_scan_at": null,
        "last_event_at": null
      },
      "flags": {
        "expired": false,
        "exhausted": false,
        "inactive_by_status": false,
        "inactive_by_activity": false,
        "broken_target": false,
        "failing": false
      }
    },
    {
      "id": 5,
      "slug": "fixture-collision-1",
      "tier": "standard",
      "assets": {
        "redirect_url": "https://ol0.me/fixture-collision-1",
        "png_url": "https://api.ol0.me/qr/fixture-collision-1.png?v=1",
        "svg_url": "https://api.ol0.me/qr/fixture-collision-1.svg?v=1"
      },
      "destination": {
        "url": "https://example.com/collision/2",
        "health": {
          "state": "unknown",
          "checked_at": null,
          "http_status": null,
          "error_message": null,
          "response_time_ms": null
        }
      },
      "status": {
        "id": 1,
        "label": "Active",
        "effective": "active"
      },
      "campaign": {
        "id": 1,
        "name": "Fixture campaign",
        "status": "completed"
      },
      "lifecycle": {
        "created_at": "2026-10-06T11:16:12.461Z",
        "updated_at": "2026-10-06T11:16:12.461Z",
        "valid_from": null,
        "valid_to": null,
        "max_usage": null
      },
      "analytics": {
        "total_scans": 0,
        "scans_in_window": 0,
        "successful_redirects_in_window": 0,
        "invalid_hits_in_window": 0,
        "inactive_hits_in_window": 0,
        "expired_hits_in_window": 0,
        "exhausted_hits_in_window": 0,
        "broken_target_hits_in_window": 0,
        "last_scan_at": null,
        "last_event_at": null
      },
      "flags": {
        "expired": false,
        "exhausted": false,
        "inactive_by_status": false,
        "inactive_by_activity": false,
        "broken_target": false,
        "failing": false
      }
    },
    {
      "id": 6,
      "slug": "fixture-collision-2",
      "tier": "standard",
      "assets": {
        "redirect_url": "https://ol0.me/fixture-collision-2",
        "png_url": "https://api.ol0.me/qr/fixture-collision-2.png?v=1",
        "svg_url": "https://api.ol0.me/qr/fixture-collision-2.svg?v=1"
      },
      "destination": {
        "url": "https://example.com/collision/3",
        "health": {
          "state": "unknown",
          "checked_at": null,
          "http_status": null,
          "error_message": null,
          "response_time_ms": null
        }
      },
      "status": {
        "id": 1,
        "label": "Active",
        "effective": "active"
      },
      "campaign": {
        "id": 1,
        "name": "Fixture campaign",
        "status": "completed"
      },
      "lifecycle": {
        "created_at": "2026-10-06T11:16:12.461Z",
        "updated_at": "2026-10-06T11:16:12.461Z",
        "valid_from": null,
        "valid_to": null,
        "max_usage": null
      },
      "analytics": {
        "total_scans": 0,
        "scans_in_window": 0,
        "successful_redirects_in_window": 0,
        "invalid_hits_in_window": 0,
        "inactive_hits_in_window": 0,
        "expired_hits_in_window": 0,
        "exhausted_hits_in_window": 0,
        "broken_target_hits_in_window": 0,
        "last_scan_at": null,
        "last_event_at": null
      },
      "flags": {
        "expired": false,
        "exhausted": false,
        "inactive_by_status": false,
        "inactive_by_activity": false,
        "broken_target": false,
        "failing": false
      }
    },
    {
      "id": 7,
      "slug": "fixture-collision-3",
      "tier": "standard",
      "assets": {
        "redirect_url": "https://ol0.me/fixture-collision-3",
        "png_url": "https://api.ol0.me/qr/fixture-collision-3.png?v=1",
        "svg_url": "https://api.ol0.me/qr/fixture-collision-3.svg?v=1"
      },
      "destination": {
        "url": "https://example.com/collision/4",
        "health": {
          "state": "unknown",
          "checked_at": null,
          "http_status": null,
          "error_message": null,
          "response_time_ms": null
        }
      },
      "status": {
        "id": 1,
        "label": "Active",
        "effective": "active"
      },
      "campaign": {
        "id": 1,
        "name": "Fixture campaign",
        "status": "completed"
      },
      "lifecycle": {
        "created_at": "2026-10-06T11:16:12.461Z",
        "updated_at": "2026-10-06T11:16:12.461Z",
        "valid_from": null,
        "valid_to": null,
        "max_usage": null
      },
      "analytics": {
        "total_scans": 0,
        "scans_in_window": 0,
        "successful_redirects_in_window": 0,
        "invalid_hits_in_window": 0,
        "inactive_hits_in_window": 0,
        "expired_hits_in_window": 0,
        "exhausted_hits_in_window": 0,
        "broken_target_hits_in_window": 0,
        "last_scan_at": null,
        "last_event_at": null
      },
      "flags": {
        "expired": false,
        "exhausted": false,
        "inactive_by_status": false,
        "inactive_by_activity": false,
        "broken_target": false,
        "failing": false
      }
    },
    {
      "id": 8,
      "slug": "fixture-collision-4",
      "tier": "standard",
      "assets": {
        "redirect_url": "https://ol0.me/fixture-collision-4",
        "png_url": "https://api.ol0.me/qr/fixture-collision-4.png?v=1",
        "svg_url": "https://api.ol0.me/qr/fixture-collision-4.svg?v=1"
      },
      "destination": {
        "url": "https://example.com/collision/5",
        "health": {
          "state": "unknown",
          "checked_at": null,
          "http_status": null,
          "error_message": null,
          "response_time_ms": null
        }
      },
      "status": {
        "id": 1,
        "label": "Active",
        "effective": "active"
      },
      "campaign": {
        "id": 1,
        "name": "Fixture campaign",
        "status": "completed"
      },
      "lifecycle": {
        "created_at": "2026-10-06T11:16:12.461Z",
        "updated_at": "2026-10-06T11:16:12.461Z",
        "valid_from": null,
        "valid_to": null,
        "max_usage": null
      },
      "analytics": {
        "total_scans": 0,
        "scans_in_window": 0,
        "successful_redirects_in_window": 0,
        "invalid_hits_in_window": 0,
        "inactive_hits_in_window": 0,
        "expired_hits_in_window": 0,
        "exhausted_hits_in_window": 0,
        "broken_target_hits_in_window": 0,
        "last_scan_at": null,
        "last_event_at": null
      },
      "flags": {
        "expired": false,
        "exhausted": false,
        "inactive_by_status": false,
        "inactive_by_activity": false,
        "broken_target": false,
        "failing": false
      }
    },
    {
      "id": 9,
      "slug": "fixture-collision-5",
      "tier": "standard",
      "assets": {
        "redirect_url": "https://ol0.me/fixture-collision-5",
        "png_url": "https://api.ol0.me/qr/fixture-collision-5.png?v=1",
        "svg_url": "https://api.ol0.me/qr/fixture-collision-5.svg?v=1"
      },
      "destination": {
        "url": "https://example.com/collision/6",
        "health": {
          "state": "unknown",
          "checked_at": null,
          "http_status": null,
          "error_message": null,
          "response_time_ms": null
        }
      },
      "status": {
        "id": 1,
        "label": "Active",
        "effective": "active"
      },
      "campaign": {
        "id": 1,
        "name": "Fixture campaign",
        "status": "completed"
      },
      "lifecycle": {
        "created_at": "2026-10-06T11:16:12.461Z",
        "updated_at": "2026-10-06T11:16:12.461Z",
        "valid_from": null,
        "valid_to": null,
        "max_usage": null
      },
      "analytics": {
        "total_scans": 0,
        "scans_in_window": 0,
        "successful_redirects_in_window": 0,
        "invalid_hits_in_window": 0,
        "inactive_hits_in_window": 0,
        "expired_hits_in_window": 0,
        "exhausted_hits_in_window": 0,
        "broken_target_hits_in_window": 0,
        "last_scan_at": null,
        "last_event_at": null
      },
      "flags": {
        "expired": false,
        "exhausted": false,
        "inactive_by_status": false,
        "inactive_by_activity": false,
        "broken_target": false,
        "failing": false
      }
    },
    {
      "id": 10,
      "slug": "fixture-collision-6",
      "tier": "standard",
      "assets": {
        "redirect_url": "https://ol0.me/fixture-collision-6",
        "png_url": "https://api.ol0.me/qr/fixture-collision-6.png?v=1",
        "svg_url": "https://api.ol0.me/qr/fixture-collision-6.svg?v=1"
      },
      "destination": {
        "url": "https://example.com/collision/7",
        "health": {
          "state": "unknown",
          "checked_at": null,
          "http_status": null,
          "error_message": null,
          "response_time_ms": null
        }
      },
      "status": {
        "id": 1,
        "label": "Active",
        "effective": "active"
      },
      "campaign": {
        "id": 1,
        "name": "Fixture campaign",
        "status": "completed"
      },
      "lifecycle": {
        "created_at": "2026-10-06T11:16:12.461Z",
        "updated_at": "2026-10-06T11:16:12.461Z",
        "valid_from": null,
        "valid_to": null,
        "max_usage": null
      },
      "analytics": {
        "total_scans": 0,
        "scans_in_window": 0,
        "successful_redirects_in_window": 0,
        "invalid_hits_in_window": 0,
        "inactive_hits_in_window": 0,
        "expired_hits_in_window": 0,
        "exhausted_hits_in_window": 0,
        "broken_target_hits_in_window": 0,
        "last_scan_at": null,
        "last_event_at": null
      },
      "flags": {
        "expired": false,
        "exhausted": false,
        "inactive_by_status": false,
        "inactive_by_activity": false,
        "broken_target": false,
        "failing": false
      }
    },
    {
      "id": 11,
      "slug": "fixture-collision-7",
      "tier": "standard",
      "assets": {
        "redirect_url": "https://ol0.me/fixture-collision-7",
        "png_url": "https://api.ol0.me/qr/fixture-collision-7.png?v=1",
        "svg_url": "https://api.ol0.me/qr/fixture-collision-7.svg?v=1"
      },
      "destination": {
        "url": "https://example.com/collision/8",
        "health": {
          "state": "unknown",
          "checked_at": null,
          "http_status": null,
          "error_message": null,
          "response_time_ms": null
        }
      },
      "status": {
        "id": 1,
        "label": "Active",
        "effective": "active"
      },
      "campaign": {
        "id": 1,
        "name": "Fixture campaign",
        "status": "completed"
      },
      "lifecycle": {
        "created_at": "2026-10-06T11:16:12.461Z",
        "updated_at": "2026-10-06T11:16:12.461Z",
        "valid_from": null,
        "valid_to": null,
        "max_usage": null
      },
      "analytics": {
        "total_scans": 0,
        "scans_in_window": 0,
        "successful_redirects_in_window": 0,
        "invalid_hits_in_window": 0,
        "inactive_hits_in_window": 0,
        "expired_hits_in_window": 0,
        "exhausted_hits_in_window": 0,
        "broken_target_hits_in_window": 0,
        "last_scan_at": null,
        "last_event_at": null
      },
      "flags": {
        "expired": false,
        "exhausted": false,
        "inactive_by_status": false,
        "inactive_by_activity": false,
        "broken_target": false,
        "failing": false
      }
    },
    {
      "id": 12,
      "slug": "fixture-collision-8",
      "tier": "standard",
      "assets": {
        "redirect_url": "https://ol0.me/fixture-collision-8",
        "png_url": "https://api.ol0.me/qr/fixture-collision-8.png?v=1",
        "svg_url": "https://api.ol0.me/qr/fixture-collision-8.svg?v=1"
      },
      "destination": {
        "url": "https://example.com/collision/9",
        "health": {
          "state": "unknown",
          "checked_at": null,
          "http_status": null,
          "error_message": null,
          "response_time_ms": null
        }
      },
      "status": {
        "id": 1,
        "label": "Active",
        "effective": "active"
      },
      "campaign": {
        "id": 1,
        "name": "Fixture campaign",
        "status": "completed"
      },
      "lifecycle": {
        "created_at": "2026-10-06T11:16:12.461Z",
        "updated_at": "2026-10-06T11:16:12.461Z",
        "valid_from": null,
        "valid_to": null,
        "max_usage": null
      },
      "analytics": {
        "total_scans": 0,
        "scans_in_window": 0,
        "successful_redirects_in_window": 0,
        "invalid_hits_in_window": 0,
        "inactive_hits_in_window": 0,
        "expired_hits_in_window": 0,
        "exhausted_hits_in_window": 0,
        "broken_target_hits_in_window": 0,
        "last_scan_at": null,
        "last_event_at": null
      },
      "flags": {
        "expired": false,
        "exhausted": false,
        "inactive_by_status": false,
        "inactive_by_activity": false,
        "broken_target": false,
        "failing": false
      }
    },
    {
      "id": 13,
      "slug": "fixture-collision-9",
      "tier": "standard",
      "assets": {
        "redirect_url": "https://ol0.me/fixture-collision-9",
        "png_url": "https://api.ol0.me/qr/fixture-collision-9.png?v=1",
        "svg_url": "https://api.ol0.me/qr/fixture-collision-9.svg?v=1"
      },
      "destination": {
        "url": "https://example.com/collision/10",
        "health": {
          "state": "unknown",
          "checked_at": null,
          "http_status": null,
          "error_message": null,
          "response_time_ms": null
        }
      },
      "status": {
        "id": 1,
        "label": "Active",
        "effective": "active"
      },
      "campaign": {
        "id": 1,
        "name": "Fixture campaign",
        "status": "completed"
      },
      "lifecycle": {
        "created_at": "2026-10-06T11:16:12.461Z",
        "updated_at": "2026-10-06T11:16:12.461Z",
        "valid_from": null,
        "valid_to": null,
        "max_usage": null
      },
      "analytics": {
        "total_scans": 0,
        "scans_in_window": 0,
        "successful_redirects_in_window": 0,
        "invalid_hits_in_window": 0,
        "inactive_hits_in_window": 0,
        "expired_hits_in_window": 0,
        "exhausted_hits_in_window": 0,
        "broken_target_hits_in_window": 0,
        "last_scan_at": null,
        "last_event_at": null
      },
      "flags": {
        "expired": false,
        "exhausted": false,
        "inactive_by_status": false,
        "inactive_by_activity": false,
        "broken_target": false,
        "failing": false
      }
    },
    {
      "id": 2,
      "slug": "fixture-001",
      "tier": "basic",
      "assets": {
        "redirect_url": "https://ol0.me/fixture-001",
        "png_url": "https://api.ol0.me/qr/fixture-001.png?v=1",
        "svg_url": "https://api.ol0.me/qr/fixture-001.svg?v=1"
      },
      "destination": {
        "url": "https://example.com/item/1",
        "health": {
          "state": "unknown",
          "checked_at": null,
          "http_status": null,
          "error_message": null,
          "response_time_ms": null
        }
      },
      "status": {
        "id": 1,
        "label": "Active",
        "effective": "active"
      },
      "campaign": {
        "id": 1,
        "name": "Fixture campaign",
        "status": "completed"
      },
      "lifecycle": {
        "created_at": "2026-10-06T11:16:12.428Z",
        "updated_at": "2026-10-06T11:16:12.428Z",
        "valid_from": null,
        "valid_to": null,
        "max_usage": null
      },
      "analytics": {
        "total_scans": 0,
        "scans_in_window": 0,
        "successful_redirects_in_window": 0,
        "invalid_hits_in_window": 0,
        "inactive_hits_in_window": 0,
        "expired_hits_in_window": 0,
        "exhausted_hits_in_window": 0,
        "broken_target_hits_in_window": 0,
        "last_scan_at": null,
        "last_event_at": null
      },
      "flags": {
        "expired": false,
        "exhausted": false,
        "inactive_by_status": false,
        "inactive_by_activity": false,
        "broken_target": false,
        "failing": false
      }
    },
    {
      "id": 3,
      "slug": "fixture-002",
      "tier": "basic",
      "assets": {
        "redirect_url": "https://ol0.me/fixture-002",
        "png_url": "https://api.ol0.me/qr/fixture-002.png?v=1",
        "svg_url": "https://api.ol0.me/qr/fixture-002.svg?v=1"
      },
      "destination": {
        "url": "https://example.com/item/2",
        "health": {
          "state": "unknown",
          "checked_at": null,
          "http_status": null,
          "error_message": null,
          "response_time_ms": null
        }
      },
      "status": {
        "id": 1,
        "label": "Active",
        "effective": "active"
      },
      "campaign": {
        "id": 1,
        "name": "Fixture campaign",
        "status": "completed"
      },
      "lifecycle": {
        "created_at": "2026-10-06T11:16:12.428Z",
        "updated_at": "2026-10-06T11:16:12.428Z",
        "valid_from": null,
        "valid_to": null,
        "max_usage": null
      },
      "analytics": {
        "total_scans": 0,
        "scans_in_window": 0,
        "successful_redirects_in_window": 0,
        "invalid_hits_in_window": 0,
        "inactive_hits_in_window": 0,
        "expired_hits_in_window": 0,
        "exhausted_hits_in_window": 0,
        "broken_target_hits_in_window": 0,
        "last_scan_at": null,
        "last_event_at": null
      },
      "flags": {
        "expired": false,
        "exhausted": false,
        "inactive_by_status": false,
        "inactive_by_activity": false,
        "broken_target": false,
        "failing": false
      }
    },
    {
      "id": 1,
      "slug": "quro-fixture",
      "tier": "standard",
      "assets": {
        "redirect_url": "https://ol0.me/quro-fixture",
        "png_url": "https://api.ol0.me/qr/quro-fixture.png?v=1",
        "svg_url": "https://api.ol0.me/qr/quro-fixture.svg?v=1"
      },
      "destination": {
        "url": "https://example.com/updated",
        "health": {
          "state": "unknown",
          "checked_at": null,
          "http_status": null,
          "error_message": null,
          "response_time_ms": null
        }
      },
      "status": {
        "id": 1,
        "label": "Active",
        "effective": "active"
      },
      "campaign": {
        "id": 1,
        "name": "Fixture campaign",
        "status": "completed"
      },
      "lifecycle": {
        "created_at": "2026-10-06T11:16:12.268Z",
        "updated_at": "2026-10-06T11:16:12.380Z",
        "valid_from": null,
        "valid_to": null,
        "max_usage": null
      },
      "analytics": {
        "total_scans": 3,
        "scans_in_window": 3,
        "successful_redirects_in_window": 3,
        "invalid_hits_in_window": 0,
        "inactive_hits_in_window": 0,
        "expired_hits_in_window": 0,
        "exhausted_hits_in_window": 0,
        "broken_target_hits_in_window": 0,
        "last_scan_at": null,
        "last_event_at": null
      },
      "flags": {
        "expired": false,
        "exhausted": false,
        "inactive_by_status": false,
        "inactive_by_activity": false,
        "broken_target": false,
        "failing": false
      }
    }
  ],
  "meta": {
    "page": 1,
    "perPage": 50,
    "total": 15,
    "hasMore": false,
    "from": "2026-09-06",
    "to": "2026-10-06",
    "refresh_health": false,
    "inactivity_days": 30
  }
}

HTTP 200. Inspect meta.hasMore and preserve filters. Unknown destination health is not healthy. Asset URLs in the response do not prove the images or redirects are deployed or reachable.

Worked response 3 · HTTP 200 · Destination probes requested

Input · payload.json:

{
  "perPage": 2,
  "refresh_health": "true"
}

Captured SDK response:

{
  "success": true,
  "data": [
    {
      "id": 16,
      "slug": "6df2of7g",
      "tier": "standard",
      "assets": {
        "redirect_url": "https://ol0.me/6df2of7g",
        "png_url": "https://api.ol0.me/qr/6df2of7g.png?v=1",
        "svg_url": "https://api.ol0.me/qr/6df2of7g.svg?v=1"
      },
      "destination": {
        "url": "mailto:reviewed@example.com",
        "health": {
          "state": "broken",
          "checked_at": "2026-10-06T11:16:13.594Z",
          "http_status": null,
          "error_message": "unsupported_target_scheme",
          "response_time_ms": 0
        }
      },
      "status": {
        "id": 1,
        "label": "Active",
        "effective": "broken_target"
      },
      "campaign": null,
      "lifecycle": {
        "created_at": "2026-10-06T11:16:13.167Z",
        "updated_at": "2026-10-06T11:16:13.197Z",
        "valid_from": null,
        "valid_to": null,
        "max_usage": null
      },
      "analytics": {
        "total_scans": 0,
        "scans_in_window": 0,
        "successful_redirects_in_window": 0,
        "invalid_hits_in_window": 0,
        "inactive_hits_in_window": 0,
        "expired_hits_in_window": 0,
        "exhausted_hits_in_window": 0,
        "broken_target_hits_in_window": 0,
        "last_scan_at": null,
        "last_event_at": null
      },
      "flags": {
        "expired": false,
        "exhausted": false,
        "inactive_by_status": false,
        "inactive_by_activity": false,
        "broken_target": true,
        "failing": true
      }
    },
    {
      "id": 14,
      "slug": "premium-fixture",
      "tier": "premium",
      "assets": {
        "redirect_url": "https://ol0.me/premium-fixture",
        "png_url": "https://api.ol0.me/qr/premium-fixture.png?v=1",
        "svg_url": "https://api.ol0.me/qr/premium-fixture.svg?v=1"
      },
      "destination": {
        "url": "https://example.com/item/premium",
        "health": {
          "state": "healthy",
          "checked_at": "2026-10-06T11:16:13.610Z",
          "http_status": 200,
          "error_message": null,
          "response_time_ms": 0
        }
      },
      "status": {
        "id": 2,
        "label": "Inactive",
        "effective": "inactive"
      },
      "campaign": null,
      "lifecycle": {
        "created_at": "2026-10-06T11:16:13.017Z",
        "updated_at": "2026-10-06T11:16:13.064Z",
        "valid_from": null,
        "valid_to": null,
        "max_usage": null
      },
      "analytics": {
        "total_scans": 2,
        "scans_in_window": 0,
        "successful_redirects_in_window": 0,
        "invalid_hits_in_window": 0,
        "inactive_hits_in_window": 0,
        "expired_hits_in_window": 0,
        "exhausted_hits_in_window": 0,
        "broken_target_hits_in_window": 0,
        "last_scan_at": null,
        "last_event_at": null
      },
      "flags": {
        "expired": false,
        "exhausted": false,
        "inactive_by_status": true,
        "inactive_by_activity": false,
        "broken_target": false,
        "failing": true
      }
    }
  ],
  "meta": {
    "page": 1,
    "perPage": 2,
    "total": 15,
    "hasMore": true,
    "from": "2026-09-06",
    "to": "2026-10-06",
    "refresh_health": true,
    "inactivity_days": 30
  }
}

HTTP 200. Inspect meta.hasMore and preserve filters. Unknown destination health is not healthy. Asset URLs in the response do not prove the images or redirects are deployed or reachable.

Verify the result

Inspect meta.hasMore and preserve filters. Unknown destination health is not healthy. Asset URLs in the response do not prove the images or redirects are deployed or reachable.

Errors and recovery

HTTP 401 · auth_error: Authenticate again in the intended environment and organization.
HTTP 403 · action_permission_required: Inspect the actual refusal. The action permission and the verified workspace access are both required; a caller cannot name an ungranted workspace.

Inspect the original handler body as well as the SDK error code. These are observed local refusals, not an exhaustive provider-failure list.

Recovery boundary

Use refresh_health="false" for cached results without destination probes. For a refresh, review the planned targets and confirm the unchanged request; after uncertainty, inspect current health before repeating probes.

Get QR analytics summary: Summarizes workspace inventory, activity, failures, campaign aggregates and top assets over the selected date window.
Get QR code: Reads one code by exact numeric id or slug within the verified workspace, including its design, scan count and series. Exact reads can return soft-deleted records.

List QR assets and health

Outcome

Before you start

Discover the target

Request

Input fields

Worked examples

Worked response 1 · HTTP 200 · Cached destination health

Worked response 2 · HTTP 200 · Cached destination health

Worked response 3 · HTTP 200 · Destination probes requested

Verify the result

Errors and recovery

Recovery boundary

Related actions

Evidence