List QR codes

Lists non-deleted workspace codes with filters, page metadata, tier counts and scan counts; basic codes remain in the same canonical inventory.

Outcome

Lists non-deleted workspace codes with filters, page metadata, tier counts and scan counts; basic codes remain in the same canonical inventory.

Before you start

Verify identity, environment and the intended organization before discovery.
Discover the published codes: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.

Discover the target

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

statusId: Discovered code status id for generation or filtering.
categoryId: Discovered category id used by a code filter or series generation.
seriesId: Discovered numeric series id used to filter inventory or assets.

Request

GET /qurocodes

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.
`limit`	No	Declared bounded result count. Event/rollup results have no continuation cursor; narrow the window when the limit is reached.
`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.
`search`	No	Text filter for codes or templates; it does not change stored records.
`statusId`	No	Discovered code status id for generation or filtering.
`categoryId`	No	Discovered category id used by a code filter or series generation.
`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.
`seriesId`	No	Discovered numeric series id used to filter inventory or assets.

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.qurocodes.list --data @payload.json --json
topolo actions plan app_topolo_quro.qurocodes.list --resource-type workspace --resource-id "$WORKSPACE_ID" --data @payload.json --json
topolo actions call app_topolo_quro.qurocodes.list --resource-type workspace --resource-id "$WORKSPACE_ID" --data @payload.json --detail --json

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

{
  "tool": "topolo_prepare_action",
  "arguments": {
    "actionId": "app_topolo_quro.qurocodes.list",
    "input": {
      "perPage": 1
    },
    "resourceType": "workspace",
    "resourceId": "ws_quro_fixture"
  }
}

{
  "tool": "topolo_read_action",
  "arguments": {
    "actionId": "app_topolo_quro.qurocodes.list",
    "input": {
      "perPage": 1
    },
    "resourceType": "workspace",
    "resourceId": "ws_quro_fixture",
    "detail": true
  }
}

Worked response 1 · HTTP 200

Input · payload.json:

{
  "perPage": 1
}

Captured SDK response:

{
  "success": true,
  "data": [
    {
      "id": 1,
      "slug": "quro-fixture",
      "url": "https://example.com/fixture",
      "status_id": 1,
      "category_id": 1,
      "created_at": "2026-10-06T11:16:12.268Z",
      "created_by": "user_quro_fixture",
      "tier": "standard",
      "series_id": 1,
      "design_version": 1,
      "deleted_at": null,
      "valid_from": null,
      "valid_to": null,
      "max_usage": null,
      "name": "Fixture QR",
      "series_name": "Fixture campaign",
      "series_status": "active",
      "design": {
        "version": 1,
        "source": "plain",
        "foreground": "#000000",
        "background": "#ffffff",
        "moduleStyle": "square",
        "finderStyle": "square",
        "brand": null
      },
      "delivery_mode": "redirect",
      "supports_publishing_state": true,
      "supports_tier_selection": true,
      "management_model": "standard",
      "scan_count": 0
    }
  ],
  "meta": {
    "page": 1,
    "perPage": 1,
    "total": 1,
    "counts": {
      "total": 1,
      "basic": 0,
      "standard": 1,
      "premium": 0,
      "unassigned": 0
    },
    "hasMore": false
  }
}