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

# List action items

> Retrieve a paginated list of action items across all meetings, with filters for status, assignee, priority, and meeting.

Returns action items extracted from your meetings. Action items are automatically created when a meeting summary is generated and can be filtered by status, assignee, priority, or meeting.

<ParamField query="limit" type="integer" default="20">
  Number of action items to return. Between 1 and 100.
</ParamField>

<ParamField query="offset" type="integer" default="0">
  Number of action items to skip for pagination.
</ParamField>

<ParamField query="status" type="string">
  Filter by status. One of `pending`, `in_progress`, or `completed`.
</ParamField>

<ParamField query="assignee" type="string">
  Filter by assignee name (partial match supported) or participant ID.
</ParamField>

<ParamField query="meeting_id" type="string">
  Return only action items from a specific meeting.
</ParamField>

<ParamField query="priority" type="string">
  Filter by priority level. One of `high`, `medium`, or `low`.
</ParamField>

<ParamField query="due_before" type="string">
  Return action items due on or before this date. ISO 8601 date format (e.g., `2026-04-15`).
</ParamField>

<ParamField query="due_after" type="string">
  Return action items due on or after this date. ISO 8601 date format.
</ParamField>

<ParamField query="sort" type="string" default="created_at">
  Sort field. One of `created_at`, `due_date`, or `priority`.
</ParamField>

<ParamField query="order" type="string" default="desc">
  Sort order. One of `asc` or `desc`.
</ParamField>

### Response

<ResponseField name="data" type="array">
  An array of action item objects.

  <Expandable title="Action item object">
    <ResponseField name="id" type="string">
      Unique action item identifier (e.g., `act_p6q7r8`).
    </ResponseField>

    <ResponseField name="title" type="string">
      Short description of the action item.
    </ResponseField>

    <ResponseField name="description" type="string | null">
      Longer description with additional context from the conversation.
    </ResponseField>

    <ResponseField name="status" type="string">
      Current status: `pending`, `in_progress`, or `completed`.
    </ResponseField>

    <ResponseField name="priority" type="string">
      Priority level: `high`, `medium`, or `low`.
    </ResponseField>

    <ResponseField name="assignee" type="object | null">
      The person assigned to this action item.

      <Expandable title="Assignee object">
        <ResponseField name="id" type="string">
          Participant identifier.
        </ResponseField>

        <ResponseField name="name" type="string">
          Assignee display name.
        </ResponseField>

        <ResponseField name="email" type="string | null">
          Assignee email if available.
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="due_date" type="string | null">
      Due date in ISO 8601 date format (e.g., `2026-04-15`). `null` if no due date was mentioned.
    </ResponseField>

    <ResponseField name="meeting_id" type="string">
      The ID of the meeting where this action item was identified.
    </ResponseField>

    <ResponseField name="meeting_title" type="string">
      The title of the associated meeting.
    </ResponseField>

    <ResponseField name="source_segment_id" type="string">
      The transcript segment ID where this action item was identified.
    </ResponseField>

    <ResponseField name="completed_at" type="string | null">
      ISO 8601 timestamp when the action item was marked as completed. `null` if not yet completed.
    </ResponseField>

    <ResponseField name="created_at" type="string">
      ISO 8601 timestamp when the action item was created.
    </ResponseField>

    <ResponseField name="updated_at" type="string">
      ISO 8601 timestamp when the action item was last updated.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="pagination" type="object">
  Pagination metadata.

  <Expandable title="Pagination object">
    <ResponseField name="total" type="integer">
      Total number of action items matching the filters.
    </ResponseField>

    <ResponseField name="limit" type="integer">
      The limit used in this request.
    </ResponseField>

    <ResponseField name="offset" type="integer">
      The offset used in this request.
    </ResponseField>

    <ResponseField name="has_more" type="boolean">
      Whether there are more results beyond this page.
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -G https://api.mavioapp.com/v1/action-items \
    -H "Authorization: Bearer mvo_live_abc123" \
    -d status=pending \
    -d priority=high \
    -d sort=due_date \
    -d order=asc
  ```

  ```python Python theme={null}
  items = client.action_items.list(
      status="pending",
      priority="high",
      sort="due_date",
      order="asc"
  )
  for item in items.data:
      print(f"[{item.priority}] {item.title} — due {item.due_date} → {item.assignee.name}")
  ```

  ```javascript Node.js theme={null}
  const { data: items } = await client.actionItems.list({
    status: 'pending',
    priority: 'high',
    sort: 'due_date',
    order: 'asc',
  });
  items.forEach(item => {
    console.log(`[${item.priority}] ${item.title} — due ${item.due_date} → ${item.assignee?.name}`);
  });
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "data": [
      {
        "id": "act_p6q7r8",
        "title": "Complete Stripe payment integration testing",
        "description": "Test the full payment flow in Stripe sandbox including successful charges, declined cards, and refund processing.",
        "status": "pending",
        "priority": "high",
        "assignee": {
          "id": "prt_g7h8i9",
          "name": "Priya Patel",
          "email": "priya@example.com"
        },
        "due_date": "2026-04-11",
        "meeting_id": "mtg_8f3k2j1m4n5p",
        "meeting_title": "Weekly Product Sync",
        "source_segment_id": "seg_003",
        "completed_at": null,
        "created_at": "2026-04-10T14:51:44Z",
        "updated_at": "2026-04-10T14:51:44Z"
      },
      {
        "id": "act_s9t0u1",
        "title": "Fix checkout page crash on Safari (BUG-442)",
        "description": "Safari 17.4 crashes on the checkout page when the user clicks the payment button. Likely related to the WebKit animation bug.",
        "status": "pending",
        "priority": "high",
        "assignee": {
          "id": "prt_d4e5f6",
          "name": "James Rodriguez",
          "email": "james@example.com"
        },
        "due_date": "2026-04-14",
        "meeting_id": "mtg_8f3k2j1m4n5p",
        "meeting_title": "Weekly Product Sync",
        "source_segment_id": "seg_017",
        "completed_at": null,
        "created_at": "2026-04-10T14:51:44Z",
        "updated_at": "2026-04-10T14:51:44Z"
      }
    ],
    "pagination": {
      "total": 8,
      "limit": 20,
      "offset": 0,
      "has_more": false
    }
  }
  ```
</ResponseExample>