List Activities (Global Feed)

Global activity feed for the active org with filters.

Returns activities of any type (meeting, message, email, call, note, etc.) sorted by effective_time desc — a generated column = COALESCE(due_at, created_at). This gives a single linear time axis regardless of activity type, so manual notes don’t get pushed to the bottom just because they lack a due_at.

GET /activities

List Activities

cURL

curl --request GET \
  --url https://api.example.com/activities \
  --header 'Authorization: Bearer <token>'

200

[
  {}
]

New to activities? See the Activities guide for what an activity is and how it attaches to other records. This page (and every other page in this section) is the field-level technical reference.

Returns activities of any type across the active org, sorted by effective_time descending. effective_time is a generated column — COALESCE(due_at, created_at) computed by Postgres, so it can never be sent on a write — and sorting by it means manual notes (no due_at) don’t get pushed to the bottom of a timeline that’s otherwise ordered by scheduled time.

Returns a bare JSON array — no total-count header, no pagination envelope. limit is capped at 500 server-side. Note that the from/to filters constrain due_at, not effective_time.

Passing a linked-filter together with its matching id-filter matches nothing: unlinked_account=true together with an explicit account_id, or unlinked_deal=true with deal_id, sends the same PostgREST query key twice (eq.<id> and is.null), which is a self-contradicting AND — you get an empty result, not an error.

Auth

Requires a CRM read scope and an active organization on the token. Any of contacts:read, deals:read, companies:read, or activities:read qualifies, as does any *:manage scope — manage implies read.

Response

Same row shape as List Meetings, except type varies per row instead of always being "meeting":

Field	Type	Description
id	string (uuid)	Primary key.
type	string	note, call, meeting, email, task, or a system-generated type.
subject	string | null	Short headline.
body	string | null	Free-text content.
due_at	string | null (timestamptz)	Scheduled time.
completed_at	string | null (timestamptz)	When the activity was marked done, if applicable.
duration_minutes	integer | null	Meeting length; usually null for non-meeting types.
metadata	object | null (jsonb)	Free-form; only meaningfully populated for meetings. See the List Meetings response for what manual vs. synced sources write into it.
account_id	string | null (uuid)	Linked account.
deal_id	string | null (uuid)	Linked deal.
contact_id	string | null (uuid)	Linked contact.
owner_id	string | null	Logto user sub of the owning rep.
source	string	manual, import, or a sync source (calendar, gmail, outlook, slack, teams).
direction	string | null	inbound | outbound, where applicable (e.g. calls, emails).
created_at	string (timestamptz)	Row creation time.
accounts	object | null	Embedded: { id, name, domain }. null if account_id is unset.
deals	object | null	Embedded: { id, name, stage_id }. null if deal_id is unset.
contacts	object | null	Embedded: { id, first_name, last_name, email }. null if contact_id is unset.

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

type · string | null

Filter to activities of this type (e.g. note, call, meeting, email, task).

source · string | null

Filter to activities from this source (manual, import, or a sync source such as calendar, gmail, outlook, slack, teams).

search · string | null

Case-insensitive substring match against subject.

contact_id · string | null

Filter to activities linked to this contact.

deal_id · string | null

Filter to activities linked to this deal.

account_id · string | null

Filter to activities linked to this account.

unlinked_account · boolean · default: false

If true, only return activities with no account_id. Combining with an explicit account_id filter yields an empty result.

unlinked_deal · boolean · default: false

If true, only return activities with no deal_id. Combining with an explicit deal_id filter yields an empty result.

exclude_future · boolean · default: false

If true, hide activities whose effective_time is later than the current UTC instant. Note this cuts at 'now', not at end of day — an activity due later today is excluded.

from · string | null

Only return activities with due_at on or after this ISO 8601 timestamp — filters due_at, not the effective_time the feed is sorted by.

to · string | null

Only return activities with due_at on or before this ISO 8601 timestamp — filters due_at, not the effective_time the feed is sorted by.

limit · integer · default: 100

Maximum rows to return; capped at 500 server-side.

offset · integer · default: 0

Number of rows to skip, for pagination.

Response

200

application/json

Successful Response