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

# List activity events

> Cursor-paginated Mission Control activity events. Filters are applied before the page limit; follow nextCursor until null.



## OpenAPI

````yaml /api-reference/openapi.json get /api/v1/orgs/{orgSlug}/activity-feed/events
openapi: 3.0.3
info:
  title: Tolmo API
  version: 1.0.0
  description: >-
    The Tolmo REST API. Every endpoint is scoped to one organization and
    authenticated with an API token.
servers:
  - url: https://api.tolmo.com
    description: Production
security:
  - bearerAuth: []
paths:
  /api/v1/orgs/{orgSlug}/activity-feed/events:
    get:
      tags:
        - activity-feed
      summary: List activity events
      description: >-
        Cursor-paginated Mission Control activity events. Filters are applied
        before the page limit; follow nextCursor until null.
      operationId: apiListOrgActivityFeedEvents
      parameters:
        - schema:
            type: integer
            minimum: 0
            exclusiveMinimum: true
            maximum: 90
          in: query
          name: sinceDays
          required: false
        - schema:
            type: string
            format: date-time
          in: query
          name: from
          required: false
        - schema:
            type: string
            format: date-time
          in: query
          name: to
          required: false
        - schema:
            type: string
          in: query
          name: types
          required: false
        - schema:
            type: string
          in: query
          name: statuses
          required: false
        - schema:
            type: string
          in: query
          name: agents
          required: false
        - schema:
            type: string
          in: query
          name: providers
          required: false
        - schema:
            type: string
          in: query
          name: names
          required: false
        - schema:
            type: string
          in: query
          name: attachments
          required: false
        - schema:
            type: string
            enum:
              - important
              - assessment
              - notable
              - all
          in: query
          name: view
          required: false
        - schema:
            type: string
          in: query
          name: showNoAgents
          required: false
        - schema:
            type: string
          in: query
          name: hideNoFindings
          required: false
        - schema:
            type: string
            maxLength: 512
          in: query
          name: cursor
          required: false
        - schema:
            default: 50
            type: integer
            minimum: 0
            exclusiveMinimum: true
            maximum: 100
          in: query
          name: limit
          required: false
        - schema:
            type: string
          in: path
          name: orgSlug
          required: true
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  events:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        timestamp:
                          type: string
                        eventName:
                          type: string
                        category:
                          type: string
                          enum:
                            - alert
                            - pull_request
                            - ci_pipeline
                            - code_change
                            - integration
                            - agent_run
                            - graph_ingest
                            - monitoring
                            - supply_chain
                            - compute
                            - datastore
                            - network
                            - identity
                            - secret
                            - resource
                            - finding
                            - pipeline
                            - unknown
                        type:
                          type: string
                          enum:
                            - Alert
                            - Vulnerability
                            - Code Change
                            - CI
                            - Compute
                            - Datastore
                            - Network
                            - Identity
                            - Secret
                            - Resource
                            - Integration Account
                            - Unknown
                        description:
                          type: string
                        provider:
                          nullable: true
                          type: string
                        agents:
                          type: array
                          items:
                            type: object
                            properties:
                              key:
                                type: string
                              slug:
                                type: string
                              label:
                                type: string
                              variant:
                                nullable: true
                                type: string
                              variantLabel:
                                nullable: true
                                type: string
                            required:
                              - key
                              - slug
                              - label
                              - variant
                              - variantLabel
                            additionalProperties: false
                        findings:
                          type: object
                          properties:
                            total:
                              type: number
                            statuses:
                              type: object
                              properties:
                                open:
                                  type: number
                                in-progress:
                                  type: number
                                resolved:
                                  type: number
                                dismissed:
                                  type: number
                              additionalProperties: false
                          required:
                            - total
                            - statuses
                          additionalProperties: false
                        findingItems:
                          type: array
                          items:
                            type: object
                            properties:
                              id:
                                type: string
                              title:
                                type: string
                              severity:
                                type: string
                              status:
                                type: string
                            required:
                              - id
                              - title
                              - severity
                              - status
                            additionalProperties: false
                        agentOutputIds:
                          type: array
                          items:
                            type: string
                        groupCount:
                          type: number
                        relevance:
                          nullable: true
                          type: string
                          enum:
                            - needs_assessment
                            - notable
                            - audit
                        relevanceReason:
                          nullable: true
                          type: string
                        assessmentState:
                          nullable: true
                          type: string
                          enum:
                            - uncovered
                            - queued
                            - running
                            - clean
                            - finding
                            - failed
                            - debounced
                      required:
                        - id
                        - timestamp
                        - eventName
                        - category
                        - type
                        - description
                        - provider
                        - agents
                        - findings
                        - findingItems
                        - agentOutputIds
                        - groupCount
                        - relevance
                        - relevanceReason
                        - assessmentState
                      additionalProperties: false
                  nextCursor:
                    nullable: true
                    type: string
                required:
                  - events
                  - nextCursor
                additionalProperties: false
        '412':
          description: Default Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HttpError'
components:
  schemas:
    HttpError:
      type: object
      properties:
        statusCode:
          type: number
        code:
          type: string
        error:
          type: string
        message:
          type: string
      title: HttpError
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        A Tolmo API token, sent as `Authorization: Bearer <token>`. Either a
        user token (`usr_tok.*`, minted by `tolmo auth login`, scoped to your
        own permissions) or an org API token created in the Tolmo app, for CI
        and automation.

````