> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qwairy.co/llms.txt
> Use this file to discover all available pages before exploring further.

# List Actions

> List the Action Center's prioritized recommendation queue

Returns the Action Center's deterministic recommendation queue for a brand: prioritized actions with a 3-tier label, a 0-100 priority score, a 1-5 demand badge, the quantified "why", the raw signals, and a step-by-step checklist.

<Note>
  **Private beta.** The Action Center must be enabled for your team; otherwise
  this endpoint returns `403`. Contact your account manager to request access.
</Note>

<ParamField header="Authorization" type="string" required>
  Bearer token. Example: `Bearer qw-api-xxx`
</ParamField>

### Path Parameters

<ParamField path="brandId" type="string" required>
  The unique identifier of the brand
</ParamField>

### Query Parameters

<ParamField query="status" type="string">
  Filter by status: `SUGGESTED` (awaiting triage), `PENDING`, `IN_PROGRESS`,
  `COMPLETED`, `DISMISSED`, `RESOLVED` (signal disappeared, auto-closed).
  Defaults to the live queue: `SUGGESTED` + `PENDING` + `IN_PROGRESS`.
</ParamField>

<ParamField query="type" type="string">
  Filter by action type: `CONTENT_GAP`, `CONTENT_OPTIMIZE`, `TECHNICAL_FIX`,
  `SCHEMA_ADD`, `AUTHORITY_BUILD`, `SOURCE_OUTREACH`, `COMPETITOR_ANALYSIS`,
  `PERCEPTION_FIX`, `SEARCH_TARGET`, `SOCIAL_ENGAGE`, `PRODUCT_OPTIMIZE`,
  `LOCAL_OPTIMIZE`
</ParamField>

<ParamField query="category" type="string">
  Filter by category: `TECHNICAL`, `CONTENT`, `AEO`, `AUTHORITY`, `VISIBILITY`
</ParamField>

<ParamField query="limit" type="number" default="50">
  Maximum number of actions to return (max: 100)
</ParamField>

<ParamField query="offset" type="number" default="0">
  Pagination offset
</ParamField>

### Response

<ResponseField name="data" type="array">
  Actions ordered by priority (highest first), then creation date.

  <Expandable title="Action object">
    <ResponseField name="id" type="string">
      Unique identifier of the action
    </ResponseField>

    <ResponseField name="type" type="string">
      Action type (see the `type` filter for values)
    </ResponseField>

    <ResponseField name="category" type="string">
      Action category
    </ResponseField>

    <ResponseField name="sourceType" type="string">
      Detector family that produced the action (e.g. `PAGE_ISSUE`,
      `QUESTION_GAP`, `SOURCE_OPPORTUNITY`, `SEARCH_QUERY`)
    </ResponseField>

    <ResponseField name="scope" type="string">
      Nature of the work: `ON_SITE`, `OFF_SITE` or `SETUP`
    </ResponseField>

    <ResponseField name="title" type="string">
      Action title
    </ResponseField>

    <ResponseField name="description" type="string">
      What to do and why
    </ResponseField>

    <ResponseField name="sourceUrl" type="string | null">
      External URL backing the action, when applicable
    </ResponseField>

    <ResponseField name="targetProvider" type="string | null">
      AI provider this action is scoped to (null = brand-level)
    </ResponseField>

    <ResponseField name="forceTier" type="string">
      Priority tier: `CRITICAL`, `HIGH` or `STANDARD`
    </ResponseField>

    <ResponseField name="priorityScore" type="number">
      Tier-anchored priority score from 0 to 100 (Critical 70-100, High 40-69,
      Standard below 40), refined by demand, effort and engine scope. Higher
      means act sooner; it never contradicts the tier.
    </ResponseField>

    <ResponseField name="demandBadge" type="number">
      Demand signal from 1 to 5
    </ResponseField>

    <ResponseField name="isQuickWin" type="boolean">
      High expected impact for low effort
    </ResponseField>

    <ResponseField name="effort" type="string">
      Estimated workload: `LOW`, `MEDIUM` or `HIGH`
    </ResponseField>

    <ResponseField name="status" type="string">
      Lifecycle status
    </ResponseField>

    <ResponseField name="signals" type="object | null">
      Raw quantified signals behind the priority (citations, fan-out
      occurrences, impressions, competitive pressure, affected pages...)
    </ResponseField>

    <ResponseField name="impactJustification" type="string | null">
      The quantified "why it matters" sentence
    </ResponseField>

    <ResponseField name="effortJustification" type="string | null">
      Explanation of the estimated effort
    </ResponseField>

    <ResponseField name="baselineMetric" type="number | null">
      Metric value when the action was created (outcome measurement)
    </ResponseField>

    <ResponseField name="targetMetric" type="number | null">
      Target metric value, when applicable
    </ResponseField>

    <ResponseField name="questionId" type="string | null">
      Linked monitored prompt, when applicable
    </ResponseField>

    <ResponseField name="checklist" type="array">
      Step-by-step execution guide
    </ResponseField>

    <ResponseField name="createdAt" type="string">
      ISO 8601 creation date
    </ResponseField>

    <ResponseField name="updatedAt" type="string">
      ISO 8601 last update date
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="pagination" type="object">
  `total`, `limit`, `offset`, `hasMore`
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://www.qwairy.co/api/v1/brands/{brandId}/actions?status=SUGGESTED&limit=10" \
    -H "Authorization: Bearer qw-api-xxx"
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "data": [
      {
        "id": "a1b2c3d4-...",
        "type": "SOURCE_OUTREACH",
        "category": "AUTHORITY",
        "sourceType": "SOURCE_OPPORTUNITY",
        "scope": "OFF_SITE",
        "title": "Get cited by: TechRadar",
        "description": "AI answers cite this source 16 times, but it doesn't mention your brand. Outreach could secure valuable citations.",
        "sourceUrl": "https://techradar.com",
        "targetProvider": null,
        "forceTier": "HIGH",
        "priorityScore": 53,
        "demandBadge": 3,
        "isQuickWin": false,
        "effort": "MEDIUM",
        "status": "SUGGESTED",
        "signals": {
          "citations": 16,
          "sourceCategory": "MEDIA",
          "competitivePressure": 2
        },
        "impactJustification": "Source cited 16x by AI answers without mentioning the brand.",
        "effortJustification": "Outreach: research the contact, pitch, and follow up.",
        "baselineMetric": null,
        "targetMetric": null,
        "questionId": null,
        "checklist": [
          "Review what content the source already cites",
          "Prepare a superior resource or expert angle",
          "Pitch the editorial contact",
          "Track the citation when secured"
        ],
        "createdAt": "2026-06-12T05:00:00.000Z",
        "updatedAt": "2026-06-12T05:00:00.000Z"
      }
    ],
    "pagination": { "total": 42, "limit": 10, "offset": 0, "hasMore": true }
  }
  ```
</ResponseExample>