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

# List organization activity events

> Returns a paginated feed of the organization’s activity events (membership changes, resource and plan lifecycle, customer and subscription events, etc.), ordered most recent first. Filter by one or more event types, by the acting user, and by an ISO timestamp window. The response is `{ items, total }`, where `total` is the count across all pages matching the filter. Requires a Nevermined API key. Requires active organization membership. Requires the organization to be on the Premium tier or higher.



## OpenAPI

````yaml /api-reference/organizations-openapi.json get /organizations/{orgId}/activity
openapi: 3.0.0
info:
  title: Nevermined Organizations API
  description: >-
    Manage a Nevermined organization programmatically — members, tiers, groups &
    budgets, treasury wallets, customers, webhooks, analytics, and
    agent-discovery surfaces.
  version: 1.0.0
  contact: {}
servers:
  - url: https://api.sandbox.nevermined.app/api/v1
    description: Sandbox
  - url: https://api.live.nevermined.app/api/v1
    description: Live
security: []
tags:
  - name: Organizations
    x-group: General
    description: Organization settings, members & roles, and workspace context.
  - name: Organizations - Billing
    x-group: Billing
    description: Tiers, subscriptions, invoices, checkout, and the public tier catalog.
  - name: Groups
    x-group: Groups & Budgets
    description: Organization groups, per-group budgets, and shared payment methods.
  - name: Organizations - Wallets
    x-group: Wallets
    description: Custodial stablecoin treasury wallets.
  - name: Organizations - Customers
    x-group: Customers
    description: The white-label customer CRM (Enterprise).
  - name: Organizations - Analytics
    x-group: Analytics
    description: Revenue, MRR, usage, conversion, and per-member metrics.
  - name: Organizations - Webhooks
    x-group: Webhooks
    description: Outbound webhook subscriptions and deliveries.
  - name: Organizations - Activity
    x-group: Activity
    description: The organization activity feed.
  - name: Organizations - Realtime
    x-group: Realtime
    description: Realtime WebSocket secret management (Enterprise).
  - name: Invitations
    x-group: Invitations
    description: Invite people to an organization.
  - name: Organizations - Integration
    x-group: Agent Discovery
    description: >-
      Public agent-discovery surfaces (llms.txt, agentic-instructions.md,
      ai-catalog.json).
paths:
  /organizations/{orgId}/activity:
    get:
      tags:
        - Organizations - Activity
      summary: List organization activity events
      description: >-
        Returns a paginated feed of the organization’s activity events
        (membership changes, resource and plan lifecycle, customer and
        subscription events, etc.), ordered most recent first. Filter by one or
        more event types, by the acting user, and by an ISO timestamp window.
        The response is `{ items, total }`, where `total` is the count across
        all pages matching the filter. Requires a Nevermined API key. Requires
        active organization membership. Requires the organization to be on the
        Premium tier or higher.
      operationId: OrganizationActivityController_list
      parameters:
        - name: orgId
          required: true
          in: path
          description: Organization ID
          schema:
            type: string
            example: org-abc123
        - name: page
          required: false
          in: query
          description: 1-based page number. Defaults to 1.
          schema:
            example: 1
            type: number
        - name: limit
          required: false
          in: query
          description: Items per page (1–200). Defaults to 50.
          schema:
            example: 50
            type: number
        - name: eventType
          required: false
          in: query
          description: >-
            Filter by event type. Accepts a single value or a comma-separated
            list. Values come from OrganizationActivityEventType (e.g.
            `plan.purchased`, `member.joined`, `customer.blocked`).
          schema:
            example: plan.purchased,member.joined
            type: string
        - name: actorUserId
          required: false
          in: query
          description: Only return events triggered by this user ID.
          schema:
            example: us-2f4a6c8e
            type: string
        - name: from
          required: false
          in: query
          description: ISO-8601 timestamp lower bound (events with occurredAt >= from).
          schema:
            example: '2026-05-01T00:00:00.000Z'
            type: string
        - name: to
          required: false
          in: query
          description: ISO-8601 timestamp upper bound (events with occurredAt < to).
          schema:
            example: '2026-06-01T00:00:00.000Z'
            type: string
      responses:
        '200':
          description: Paginated activity events as `{ items, total }`
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OrganizationActivityEventPageDto'
        '401':
          description: Missing or invalid Nevermined API key
        '403':
          description: >-
            Caller is not an organization member, or the org is not on the
            Premium tier or higher
      security:
        - Authorization: []
components:
  schemas:
    OrganizationActivityEventPageDto:
      type: object
      properties:
        items:
          description: Page of activity events ordered by occurredAt DESC
          type: array
          items:
            $ref: '#/components/schemas/OrganizationActivityEventResponseDto'
        total:
          type: number
          description: Total number of events matching the filter (across all pages)
      required:
        - items
        - total
    OrganizationActivityEventResponseDto:
      type: object
      properties:
        id:
          type: string
          description: Activity event ID (ae-{uuid})
        eventType:
          type: string
          enum:
            - member.invited
            - member.joined
            - member.role_changed
            - member.deactivated
            - member.reactivated
            - member.removed
            - invitation.revoked
            - invitation.expired
            - group.created
            - group.updated
            - group.deactivated
            - group.member_added
            - group.member_removed
            - group.budget_set
            - group.budget_threshold_reached
            - group.budget_exceeded
            - group.budget_reset
            - agent.created
            - plan.created
            - plan.updated
            - plan.purchased
            - customer.added
            - customer.blocked
            - customer.unblocked
            - subscription.upgraded
            - subscription.downgraded
            - subscription.canceled
            - subscription.lapsed
            - webhook.delivered
            - webhook.failed
            - apikey.created
            - apikey.revoked
            - credits.redeemed
          description: The type of event that occurred
        actorUserId:
          type: string
          description: >-
            The user ID of the actor who triggered the event, or null for system
            events
          nullable: true
        subject:
          type: object
          properties:
            kind:
              type: string
              example: plan
              description: The kind of resource, e.g. plan / agent / member
            id:
              type: string
              example: pl-abc123
              description: The resource identifier
          required:
            - kind
            - id
          additionalProperties: true
          description: >-
            The resource the event is about — `{ kind, id }` plus
            event-type-specific extra keys
        metadata:
          type: object
          additionalProperties: true
          description: Optional free-form extra payload (e.g. role change before/after)
          nullable: true
        occurredAt:
          format: date-time
          type: string
          description: When the event occurred
      required:
        - id
        - eventType
        - subject
        - occurredAt
  securitySchemes:
    Authorization:
      scheme: bearer
      bearerFormat: JWT
      type: http

````

## Related topics

- [Activity & Events](/docs/solutions/organizations/activity-and-events.md)
- [Organizations](/docs/solutions/organizations/overview.md)
- [Organizations & Workspaces](/docs/integrate/patterns/organizations.md)
- [Customers](/docs/solutions/organizations/customers.md)
- [Platform Partners](/docs/integrations/organizations.md)
