Marketo API

Getting access, Developing, Testing

Back to Marketo

Get Named Account Lists

Retrieves a list of named account list records based on the filter type and values given. Required Permissions: Read-Only Named Account List, Read-Write Named Account List

Input

type: object properties: parameters: type: object properties: filterType: type: string description: >- The named account list field to filter on ("dedupeFields" or "idFields"). filterValues: type: array items: type: string description: Comma-separated list of values to match against batchSize: type: integer format: int32 description: The batch size to return. The max and default value is 300. nextPageToken: type: string description: >- 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. required: - filterType - filterValues title: Parameters

Output

required: - errors - requestId - result - success - warnings type: object properties: errors: type: array description: Array of errors that occurred if the request was unsuccessful items: required: - code - message type: object properties: code: type: string description: >- Error code of the error. See full list of error codes <a href="https://developers.marketo.com/rest-api/error-codes/">here</a> message: type: string description: Message describing the cause of the error moreResult: type: boolean description: Boolean indicating if there are more results in subsequent pages example: false nextPageToken: type: string description: Paging token given if the result set exceeded the allowed batch size requestId: type: string description: Id of the request made result: type: array description: Array of results for individual records in the operation, may be empty items: required: - marketoGUID - seq type: object properties: createdAt: type: string description: Datetime when the named account list was created marketoGUID: type: string description: Unique GUID of the custom object records name: type: string description: Name of named account list reasons: type: array description: >- List of reasons why an operation did not succeed. Reasons are only present in API responses and should not be submitted items: required: - code - message type: object properties: code: type: string description: Integer code of the reason message: type: string description: Message describing the reason for the status of the operation seq: type: integer description: >- Integer indicating the sequence of the record in response. This value is correlated to the order of the records included in the request input. Seq should only be part of responses and should not be submitted. format: int32 status: type: string enum: - created - updated - deleted - skipped - added - removed type: type: string description: >- Type of named account list ("default" if created by user or API, "external" if managed by CRM-View) updateable: type: boolean description: >- Whether the list is updateable (true if created by user or API, false if managed by CRM-View) example: false updatedAt: type: string description: Datetime when the named account list was most recently updated success: type: boolean description: Whether the request succeeded example: false warnings: type: array description: Array of warnings given for the operation items: required: - code - message type: object properties: code: type: integer description: Integer code of the warning format: int32 message: type: string description: Message describing the warning