> ## Documentation Index > Fetch the complete documentation index at: https://kavenio.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # List activity events > Returns recent activity events for the authenticated organization, optionally filtered by subject, platform, severity, or time range. ## OpenAPI ````yaml /api/openapi.json get /v1/activity openapi: 3.1.0 info: title: Kavenio API version: 1.0.0 license: name: Proprietary url: https://kavenio.com/terms description: Generated OpenAPI document for the stable Kavenio public API. servers: - url: https://api.kavenio.com security: - bearerAuth: [] tags: - name: API keys description: Manage Kavenio API keys for the authenticated user. - name: Integrations description: Connect automation clients and manage workflow subscriptions. - name: Feature requests description: Submit feature requests from authenticated users. - name: Posts description: Create, schedule, update, and manage post lifecycle actions. - name: Queue description: Manage reusable post queue schedules and preview slots. - name: Media description: Upload, presign, and validate media assets. - name: Validation description: Validate post payloads and platform content length limits. - name: Connect description: Start and complete account connection flows. - name: Accounts description: Manage connected social accounts and account health. - name: Telegram description: Manage Telegram-specific connected account settings. - name: Discord description: Manage Discord messages, roles, pins, events, and settings. - name: Google Business description: Manage Google Business locations, reviews, and helpers. - name: Ads description: Create, read, cancel, and inspect advertising resources. - name: Ad audiences description: Manage advertising audiences and audience members. - name: Ad catalogs description: Inspect advertising catalogs and product sets. - name: Ad targeting description: Search targeting entities and estimate audience reach. - name: Ad conversions description: Manage conversion destinations and send conversion events. - name: Ad leads description: Manage lead forms and retrieve advertising leads. - name: Tracking tags description: Manage Meta tracking tags and tag sharing. - name: Platform credentials description: Manage organization platform app credentials. - name: Analytics description: Read provider analytics and operational inbox data. - name: WhatsApp conversions description: Read and send WhatsApp conversion events. - name: Activity description: Read operational activity events. - name: Webhooks description: Manage webhook endpoints and delivery logs. paths: /v1/activity: get: tags: - Activity summary: List activity events description: >- Returns recent activity events for the authenticated organization, optionally filtered by subject, platform, severity, or time range. operationId: listActivityEvents parameters: - in: query name: eventId schema: type: string minLength: 16 maxLength: 16 pattern: ^[abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ]{16}$ - in: query name: profileId schema: type: string minLength: 1 maxLength: 255 - in: query name: accountId schema: type: string minLength: 16 maxLength: 16 pattern: ^[abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ]{16}$ - in: query name: platform schema: type: string enum: - twitter - facebook - instagram - linkedin - tiktok - youtube - threads - reddit - pinterest - bluesky - mastodon - googlebusiness - telegram - snapchat - discord - whatsapp - metaads - googleads - tiktokads - linkedinads - pinterestads - xads - in: query name: subjectType schema: type: string enum: - account - post - ad - webhook - billing - organization - profile - system - in: query name: subjectId schema: type: string minLength: 1 - in: query name: type schema: type: string minLength: 1 - in: query name: severity schema: type: string enum: - info - warning - error - in: query name: occurredFrom schema: type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ - in: query name: occurredTo schema: type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ - in: query name: limit schema: default: 50 type: integer minimum: 1 maximum: 100 responses: '200': description: Activity events returned. content: application/json: example: ok: true data: events: - id: hhhhhhhhhhhhhhhh organizationId: iiiiiiiiiiiiiiii profileId: null accountId: null platform: null subjectType: system subjectId: null actorId: system actorType: system requestId: request_123 type: webhook.delivery_succeeded severity: info message: Webhook delivery succeeded. metadata: {} occurredAt: '2026-06-25T12:00:00.000Z' createdAt: '2026-06-25T12:00:00.000Z' schema: type: object properties: ok: type: boolean x-kavenio-const: true data: type: object properties: events: type: array items: type: object properties: id: type: string minLength: 16 maxLength: 16 pattern: >- ^[abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ]{16}$ organizationId: type: string minLength: 1 profileId: anyOf: - type: string minLength: 1 maxLength: 255 - type: 'null' accountId: anyOf: - type: string minLength: 16 maxLength: 16 pattern: >- ^[abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ]{16}$ - type: 'null' platform: anyOf: - type: string enum: - twitter - facebook - instagram - linkedin - tiktok - youtube - threads - reddit - pinterest - bluesky - mastodon - googlebusiness - telegram - snapchat - discord - whatsapp - metaads - googleads - tiktokads - linkedinads - pinterestads - xads - type: 'null' subjectType: type: string enum: - account - post - ad - webhook - billing - organization - profile - system subjectId: anyOf: - type: string minLength: 1 - type: 'null' actorId: anyOf: - type: string minLength: 1 - type: 'null' actorType: anyOf: - type: string enum: - user - api_key - oauth_client - system - unknown - type: 'null' requestId: anyOf: - type: string minLength: 1 - type: 'null' type: type: string minLength: 1 severity: type: string enum: - info - warning - error message: type: string minLength: 1 metadata: type: object propertyNames: type: string additionalProperties: {} occurredAt: type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ createdAt: type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ required: - id - organizationId - profileId - accountId - platform - subjectType - subjectId - actorId - actorType - requestId - type - severity - message - metadata - occurredAt - createdAt additionalProperties: false required: - events additionalProperties: false required: - ok - data additionalProperties: false '401': description: Authentication failed. content: application/json: schema: type: object properties: ok: type: boolean x-kavenio-const: false error: type: object properties: code: type: string minLength: 1 message: type: string minLength: 1 details: {} required: - code - message additionalProperties: false required: - ok - error additionalProperties: false '422': description: Query parameter validation failed. content: application/json: schema: type: object properties: ok: type: boolean x-kavenio-const: false error: type: object properties: code: type: string minLength: 1 message: type: string minLength: 1 details: {} required: - code - message additionalProperties: false required: - ok - error additionalProperties: false '500': description: Activity lookup failed. content: application/json: schema: type: object properties: ok: type: boolean x-kavenio-const: false error: type: object properties: code: type: string minLength: 1 message: type: string minLength: 1 details: {} required: - code - message additionalProperties: false required: - ok - error additionalProperties: false components: securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: Clerk session or OAuth token ````