BizKitHub
DocsAPI ReferenceActivity/bff/activity/list
getActivityAdmin BFF

/bff/activity/list

Returns a paginated list of activity entries for the current organisation. Supports filtering by event type, polymorphic subject, actor (member/contact/system/cron/api), target contact, level, time range, and correlation id.

ActivitygetBffActivityList

Parameters

15 query

Query parameters

· 15
pagestringOptional

Page number (1-based) for pagination.

Example1
limitstringOptional

Maximum items per page (1–500, default 50).

Example50
typestringOptional

Filter by event type (e.g. order.create).

Exampleorder.create
subjectEntitystringOptional

Polymorphic subject entity (DB table name). Used together with subjectId to load the "Activity" tab on a specific entity detail page.

Exampleshop__order
subjectIdstringOptional

Polymorphic subject row id.

Example1234
actorstringOptional

Composite actor filter from the admin "Kto" dropdown. Format: member:<external_id> or contact:<external_id> (16-char shop__contact.external_id).

Examplemember:6NZboqKESgMFufqe
actorKind"member" | "contact" | "system" | "cron" | "api"Optional

Filter by actor kind.

Examplemember
actorMemberIdstringOptional

Filter by a specific staff member as actor (cas__organisation_member.id).

Example42
actorContactExternalIdstringOptional

External 16-char id of the contact who acted.

ExampleDlko1bEG85c6304a
targetContactExternalIdstringOptional

External 16-char id of the contact the action was directed at.

ExampleDlko1bEG85c6304a
contactExternalIdstringOptional

External 16-char id matching the contact in either role — actor OR target. Used by the "Aktivity" tab on the contact detail page where the operator wants to see everything about a contact regardless of which side they played.

ExampleDlko1bEG85c6304a
minLevelstringOptional

Minimum level (0 info, 1 notice, 2 warning).

Example1
dateFromstringOptional

ISO timestamp — events after this point.

Example2026-01-01T00:00:00Z
dateTostringOptional

ISO timestamp — events before this point.

Example2026-12-31T23:59:59Z
correlationIdstringOptional

Group all activities from one HTTP request / cron run.

Exampleiad1::cdy5w-1758481392361

Response schema

1 status code documented

200Success

This response returns no JSON body.

Response example

application/json
{
  "success": true
}

Request example

GET /bff/activity/list

get
curl -X GET "https://api.bizkithub.com/bff/activity/list?page=1&limit=50&type=order.create&subjectEntity=shop__order&subjectId=1234&actor=member%3A6NZboqKESgMFufqe&actorKind=member&actorMemberId=42&actorContactExternalId=Dlko1bEG85c6304a&targetContactExternalId=Dlko1bEG85c6304a&contactExternalId=Dlko1bEG85c6304a&minLevel=1&dateFrom=2026-01-01T00%3A00%3A00Z&dateTo=2026-12-31T23%3A59%3A59Z&correlationId=iad1%3A%3Acdy5w-1758481392361" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY"

Need an API key?

All BizKitHub public API endpoints require authentication via API key.

Get API Key