Get Lists by Lead Id

GET /rest/v1/leads/{leadId}/listMembership.json

Query static list membership for one lead.

Operation ID: getListMembershipUsingGET
Permissions: Read-Only Asset
Request format: application/json
Returns: ResponseOfLists

Parameters

Path 1

leadId integer (int64) required

The Marketo lead id

Query 2

nextPageToken string

A token will be returned by this endpoint if the result set is greater than the batch size and can be passed in a subsequent call through this parameter. See Paging Tokens for more info.

batchSize integer (int32)

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

Responses

200 OK ResponseOfLists

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 List required

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

Model List

createdAt string required

Datetime when the static list was created

listId integer (int32) required

Unique integer id of the static list

updatedAt string required

Datetime when the static list was most recently updated

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": [
    {
      "createdAt": "string",
      "listId": 123,
      "updatedAt": "string"
    }
  ],
  "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.