Get Lead Changes
Returns a list of Data Value Changes and New Lead activities after a given datetime. 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.
Parameters
Query 5
nextPageToken string requiredToken representation of a datetime returned by the Get Paging Token endpoint. This endpoint will return activities after this datetime
fields array of string requiredComma-separated list of field names to return changes for. Field names can be retrieved with the Describe Lead API.
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 ResponseOfLeadChange
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 LeadChange required
Array of results for individual records in the operation, may be empty
Model LeadChange
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) fields array of LeadChangeField
Model LeadChangeField
id integer (int32) required Unique integer id of the change record
name string required Name of the field which was changed
newValue string required New value after the change
oldValue string Old value before the change
id integer (int64) required Integer id of the activity. 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)
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,
"fields": [
{
"id": 123,
"name": "Example name",
"newValue": "string",
"oldValue": "string"
}
],
"id": 123,
"leadId": 123,
"marketoGUID": "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.