Skip to main content
GET
/
v1
/
contacts
/
{id}
/
activities
List Contact Activities
curl --request GET \
  --url https://api.example.com/v1/contacts/{id}/activities
{
  "data": {
    "activities": [
      {
        "id": "<string>",
        "type": "<string>",
        "title": "<string>",
        "description": "<string>",
        "contact_id": "<string>",
        "deal_id": "<string>",
        "entity_type": "<string>",
        "entity_id": "<string>",
        "entity_name": "<string>",
        "metadata": {},
        "created_by_user_id": "<string>",
        "created_date": "<string>"
      }
    ]
  },
  "meta": {
    "page": 123,
    "per_page": 123,
    "total": 123
  }
}

​
Request

​
Path Parameters

​
id
string
required
The contact’s unique ID (UUID)

​
Query Parameters

​
page
integer
default:"1"
Page number for pagination
​
per_page
integer
default:"50"
Activities per page (max: 100)
​
type
string
Filter by activity type: call, email, meeting, note, task, ai_action, deal_stage_change, list_added, campaign_sent, etc.
​
from_date
string
Only activities on or after this ISO 8601 timestamp
​
to_date
string
Only activities on or before this ISO 8601 timestamp

​
Headers

Authorization: Bearer wbk_your_api_key_here
Requires an API key with the activities:read permission. Activities are returned newest first.

​
Response

​
data
object
​
meta
object
curl "https://data.leadlex.com/functions/v1/api-gateway/v1/contacts/123e4567-e89b-12d3-a456-426614174000/activities?type=email" \
  -H "Authorization: Bearer wbk_your_api_key_here"

​
Example Response

{
  "data": {
    "activities": [
      {
        "id": "act_7f3c4d2a",
        "type": "email",
        "title": "Sent: Quick question about Acme Corp",
        "description": "Hi Jane, ...",
        "contact_id": "123e4567-e89b-12d3-a456-426614174000",
        "deal_id": "3f8e1d2c-4b5a-6d7e-8f9a-0b1c2d3e4f5a",
        "entity_type": "campaign",
        "entity_id": "cmp_abc123",
        "entity_name": "Q2 GC Outreach",
        "metadata": { "opened": true, "replied": false },
        "created_by_user_id": "9a8b7c6d-5e4f-3a2b-1c0d-9e8f7a6b5c4d",
        "created_date": "2026-04-17T14:23:05Z"
      }
    ]
  },
  "meta": { "page": 1, "per_page": 50, "total": 87 }
}

​
Errors

StatusCodeDescription
401invalid_keyInvalid or expired API key
403insufficient_permissionsMissing activities:read permission
404contact_not_foundNo contact with this ID
429rate_limitedRate limit exceeded