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

limit?integer

Number of items per page (max 100)

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/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"  }}