List Recent Activity

Retrieve a paginated list of recent activity for the workspace associated with your Developer API key. Responses contain a concise event projection and do not include raw activity attributes.

Event Types

Values supported by the event type filter

The event_types filter accepts a JSON-encoded array containing any of the following values:

event, contact_created, contact_updated, contact_deleted, contact_subscribed, contact_unsubscribed, segment_created, segment_updated, comment_created, and comment_updated.

GET
/v1/activity

List recent activity in the authenticated workspace

Request body

event_typesarray

JSON-encoded array of event types to include

searchstring

Search event and subject names. Maximum 200 characters.

sincestring

Return activity created at or after this ISO 8601 date or timestamp.

pagenumber

Page number. Defaults to `1`.

per_pagenumber

Results per page. Defaults to `20` and has a maximum of `25`.

Request
cURL
curl --get "https://api.leadpush.io/v1/activity" \
  --data-urlencode 'event_types=["contact_created","contact_updated"]' \
  --data-urlencode 'since=2026-10-01T00:00:00Z' \
  --data-urlencode 'per_page=20' \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {token}"
Response Example
{
  "data": [
    {
      "uuid": "<activity_uuid>",
      "event_type": "contact_created",
      "event_name": "Contact created",
      "subject": {
        "type": "contacts",
        "uuid": "<contact_uuid>",
        "name": "person@example.com",
        "deleted": false
      },
      "created_at": "2026-10-07T15:30:00.000000Z"
    }
  ],
  "meta": {
    "current_page": 1,
    "per_page": 20,
    "total": 1,
    "last_page": 1,
    "has_next": false
  }
}

Response Boundaries

Activity data intentionally kept concise

  • Results are ordered from newest to oldest.
  • Raw activity attributes and internal event payloads are not returned.
  • Subject identifiers are scoped to the API key's workspace.