Get Lead Activities

GET /rest/v1/activities.json

Returns a list of activities from after a datetime given by the `nextPageToken` parameter. Also allows for filtering by lead static list membership, or by a list of up to 30 lead ids. Beginning 2026-09-30, calls to the `Get Lead Activities` and `Get Lead Changes` endpoints which includes the `listId` parameter will fail (error code 1003) if the target lists contain 10,000 or more leads. To avoid service disruptions, ensure that calls are properly scoped to avoid this limit.

Operation ID: getLeadActivitiesUsingGET
Permissions: Read-Only Activity, Read-Write Activity
Request format: application/json
Returns: ResponseOfActivity

Parameters

Query 6

nextPageToken string required

Token representation of a datetime returned by the Get Paging Token endpoint. This endpoint will return activities after this datetime

activityTypeIds array of integer required

Comma-separated list of activity type ids. These can be retrieved with the Get Activity Types API.

assetIds array of integer

Id of the primary asset for an activity. This is based on the primary asset id of a given activity type. Should only be used when a single activity type is set

listId integer (int32)

Id of a static list. If set, will only return activities of members of this static list.

leadIds array of integer

Comma-separated list of lead ids. If set, will only return activities of the leads with these ids. Allows up to 30 entries.

batchSize integer (int32)

Maximum number of records to return. Maximum and default is 300.

Responses

200 OK ResponseOfActivity

errors array of Error required

Array of errors that occurred if the request was unsuccessful

Model Error

code string required

Error code of the error. See full list of error codes here

message string required

Message describing the cause of the error

moreResult boolean

Boolean indicating if there are more results in subsequent pages

nextPageToken string

Paging token given if the result set exceeded the allowed batch size

requestId string required

Id of the request made

result array of Activity required

Array of results for individual records in the operation, may be empty

Model Activity

activityDate string (date-time) required

Datetime of the activity

activityTypeId integer (int32) required

Id of the activity type

attributes array of Attribute required

List of secondary attributes

Model Attribute

apiName string

name string required

Name of the attribute

value object required

Value of the attribute

campaignId integer (int64)

Id of the associated Smart Campaign, if applicable

id integer (int64) required

Integer id of the activity. This value could exceed Int.MAX. For instances which have been migrated to Activity Service, this field may not be present, and should not be treated as unique.

leadId integer (int64) required

Id of the lead associated to the activity

marketoGUID string

Unique id of the activity (128 character string)

primaryAttributeValue string

Value of the primary attribute

primaryAttributeValueId integer (int64)

Id of the primary attribute field

success boolean required

Whether the request succeeded

warnings array of Warning required

Array of warnings given for the operation

Model Warning

code integer (int32) required

Integer code of the warning

message string required

Message describing the warning

Generated example

{
  "errors": [
    {
      "code": "string",
      "message": "string"
    }
  ],
  "moreResult": false,
  "nextPageToken": "example-token",
  "requestId": "123",
  "result": [
    {
      "activityDate": "2026-01-15T10:30:00Z",
      "activityTypeId": 123,
      "attributes": [
        {
          "apiName": "Example name",
          "name": "Example name",
          "value": {}
        }
      ],
      "campaignId": 123,
      "id": 123,
      "leadId": 123,
      "marketoGUID": "123",
      "primaryAttributeValue": "string",
      "primaryAttributeValueId": 123
    }
  ],
  "success": false,
  "warnings": [
    {
      "code": 123,
      "message": "string"
    }
  ]
}

Referenced models

Generated from swagger-mapi.json. Generated examples are inferred from the schema; they are illustrative and may not be valid production payloads.