Leads

List Lead Activities

Retrieve a paginated list of activities for a specific lead. Returns activity data including event types, timestamps, and associated data. Results are filtered by the organization associated with the API key.

GET
/v1/leads/{leadId}/activities

Authorization

bearerAuth
AuthorizationBearer <token>

Bearer token authentication for API access.

In: header

Path Parameters

leadId*string

The unique identifier of the lead

Query Parameters

page?integer

Page number for pagination

Default1
Range1 <= value
limit?integer

Number of items per page (max 100)

Default50
Range1 <= value <= 100

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://api.sophiie.ai/v1/leads/ld_abc123/activities"
{
  "activities": [
    {
      "id": 456,
      "event": "LEAD_CREATED",
      "data": "Status changed from pending to active",
      "referenceId": "apt_abc123",
      "userId": "usr_abc123",
      "leadId": "ld_abc123",
      "createdAt": "2023-01-01T00:00:00.000Z"
    }
  ],
  "totalPages": 5,
  "currentPage": 1,
  "totalCount": 42
}
{
  "success": false,
  "message": "Invalid or expired token",
  "error": {
    "status": 401,
    "message": "Invalid or expired token"
  }
}
{
  "success": false,
  "message": "Not found",
  "error": {
    "status": 404,
    "message": "Not found"
  }
}
{
  "success": false,
  "message": "Internal server error",
  "error": {
    "status": 500,
    "message": "Internal server error"
  }
}