Activities API
GET/api/v1/activities
Product availabilityAlgaPSA

List user activities

Returns the authenticated caller's unified activity list — a fan-out across tickets, project tasks, schedule entries, ad-hoc items, workflow tasks, time entries and notifications. Filter by activity type(s), open/closed status, priority, due-date window, free-text search and a date window; sort via `sortBy`/`sortDirection`. By default the result is paginated (ActivityListResponseV1). When `groupBy` is supplied the result is instead grouped server-side into ordered, counted buckets (ActivityGroupedResponseV1) and `page`/`pageSize` are ignored.

Query parameters

typestringOptional
Comma-separated ActivityType values (e.g. "ticket,schedule"). Omit for all types.
statusstringOptional
Open/closed filter. `open`→active only, `closed`→closed, `all`→no filter (default).
searchstringOptional
Free-text search across activity titles/descriptions.
dateStartstring <date-time>Optional
ISO 8601 lower bound of the schedule/time-entry/notification window.
dateEndstring <date-time>Optional
ISO 8601 upper bound of the window.
prioritystringOptional
Comma-separated normalized ActivityPriority buckets (e.g. "high,medium"). Lossy for custom schemes; prefer `priorityIds`.
priorityIdsstringOptional
Comma-separated exact priority IDs (the tenant's real per-type priorities). Applies to ticket/project-task activities.
dueDateStartstring <date-time>Optional
ISO 8601 lower bound of the due-date filter (independent of the schedule window).
dueDateEndstring <date-time>Optional
ISO 8601 upper bound of the due-date filter.
createdAtStartstring <date-time>Optional
ISO 8601 lower bound of the created-date ("date entered") filter. Applies to every activity type.
createdAtEndstring <date-time>Optional
ISO 8601 upper bound of the created-date ("date entered") filter.
sortBystringOptional
Sort column. Omit for the default sort (priority high→low, then due date ascending).
sortDirectionstringOptional
Sort direction for `sortBy` (default asc). Ignored when `sortBy` is omitted.
groupBystringOptional
When set, the response is grouped by this dimension (ActivityGroupedResponseV1) instead of the paginated list; `page`/`pageSize` are ignored. `priority` groups by the real per-tenant priority name (not the normalized bucket), so it is only meaningful when scoped to a single prioritized type.
pageintegerOptional
1-based page number (default 1). Ignored when `groupBy` is set.
pageSizeintegerOptional
Items per page, max 100 (default 25). Ignored when `groupBy` is set.

Response body

Success response 200 · schema ActivityListResponseV1

dataarray of objectRequired
itemsobject
idstringRequired
titlestringRequired
descriptionstring
typestringRequired
Enum: scheduleprojectTasktickettimeEntryworkflowTasknotificationdocument
statusstringRequired
statusColorstring
prioritystringRequired
Enum: lowmediumhigh
priorityNamestring
priorityColorstring
dueDatestring
startDatestring
endDatestring
assignedToarray of string
itemsstring
assignedToNamesarray of string
itemsstring
sourceIdstringRequired
sourceTypestringRequired
Enum: scheduleprojectTasktickettimeEntryworkflowTasknotificationdocument
actionsarray of objectRequired
itemsobject
idstringRequired
labelstringRequired
iconstring
disabledboolean
disabledReasonstring
isClosedboolean
tenantstringRequired
createdAtstringRequired
updatedAtstringRequired
paginationobjectRequired
pagenumberRequired
limitnumberRequired
totalnumberRequired
totalPagesnumberRequired
hasNextbooleanRequired
hasPrevbooleanRequired
metaany

Response codes

200
Paginated activity list, or grouped buckets when `groupBy` is set.
400
Invalid query parameters.
401
Authentication required (no session and no/invalid x-api-key).
403
Permission denied for one of the underlying activity sources.
500
Unexpected failure resolving activities.