Get activity by organization

GET

/api/v1/activity/organizations/{orgId}

curl --request GET \
  --url 'http://localhost:3000/api/v1/activity/organizations/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0?limit=50&offset=0' \
  --header 'X-API-Key: <X-API-Key>'

• Development
• Production

Retrieves activity logs for a specific organization/tenant. Requires Super Admin privileges.

Authorizations

• api-key
• bearer

Parameters

Path Parameters

orgId

required

string format: uuid

Organization UUID

Query Parameters

userId

string

Filter by user ID

organizationId

string

Filter by tenant/organization ID

activityTypes

Array<string>

Filter by activity types

targetUserId

string

Filter by target user ID

startDate

string

Filter by start date

endDate

string

Filter by end date

success

boolean

Filter by success status

search

string

Search text

limit

number

default: 50

Number of items per page

offset

number

0

Offset for pagination

Header Parameters

x-organization-id

string format: uuid

UUID of the organization (tenant) the request acts in. It selects the tenant and grants nothing: the server checks membership or an open tenant switch. Not needed for global operations. A malformed value returns 400. API keys are fixed to their own organization; another organization returns 403. The x-organization-source header grants nothing.

Responses

200

Organization activity retrieved successfully

Media typeapplication/json

object

items

required

Activities

Array<object>

object

id

required

Activity ID

string

user

required

User who performed the activity

object

targetUser

Target user (if applicable)

object

activityType

required

Activity type

string

organizationId

Organization ID

string

ipAddress

IP address

string

userAgent

User agent

string

description

Description

string

success

required

Success status

boolean

errorMessage

Error message

string

createdAt

required

Created at

string format: date-time

metadata

Metadata

object

total

required

Total count

number

limit

required

Limit

number

offset

required

Offset

number

Example^generated

{
  "items": [
    {
      "id": "example",
      "user": {},
      "targetUser": {},
      "activityType": "example",
      "organizationId": "example",
      "ipAddress": "example",
      "userAgent": "example",
      "description": "example",
      "success": true,
      "errorMessage": "example",
      "createdAt": "2026-04-15T12:00:00Z",
      "metadata": {}
    }
  ],
  "total": 1,
  "limit": 1,
  "offset": 1
}

401

Unauthorized

403

Forbidden - Super Admin required

404

Organization not found