Back to API references

SOAP API method ProcessedEmailing_destinations

Description

With the result parameter it is possible to filter the destinations by result. Example: if the parameter result is set to 'error', only the destinations that have result 'error' are returned. Each destination has at most one main result, so the sum of the number of destination for each possible result equals the total number of destinations.

Parameters

Name Type Description
id * int Unique identifier (id) of the object ProcessedEmailing. The method only applies to the processedemailing with this id.
result string The required result for the destination, possible values are 'error', 'success' or 'none'. Specify false if the result does not matter. There IS a difference between 'none' and false: 'none' returns all destinations with an unknown result, false returns all destinations, no matter the result. Specific mailings may also define additional results
mergecurrent boolean Should the destinations be merged with current profiles or subprofiles? If the merge is performed, this method only returns destination objects for (sub)profiles that still exist
order string The order for the destinations. Possible value are 'timestamp' and 'id'. You can also specify all possible fields from the fields of the (sub)profiles
asc boolean Order in ascending or descending order?
login Structure of type 'login' Optional login data (soon deprecated)
access_token string Optional api access token
start int Optional parameter that specifies the first element in the collection to be returned. If this parameter is omitted, the first entry in the collection is also the first entry that is returned. Use this parameter is you only want to retrieve a part of the collection.
length int Optional parameter that can be used to limit the number of returned elements of this method. If this parameter is omitted, all entries in the collection are returned. If you specify a length, this method will not return more than the specified number of entries.
allproperties boolean Optional parameter that specifies if only a limited number of properties of the requested objects are returned or, when this parameter is set to true, whether all properties of the objects are returned.
* required parameters

Return values

Name Type Description
start int The first element of the collection
length int The number of elements that are returned
total int The total available elements of the collection
allproperties int When this element is available in the return value, the objects in the collection are fully filled, otherwise only a limited number of fields from the objects are filled
faxmailingdestination Collection of type 'faxmailingdestination'
smsmailingdestination Collection of type 'smsmailingdestination'
emailingdestination Collection of type 'emailingdestination'

Structure 'login'

Name Type Description
username string The username of the login attempt
account string The account name of the login attempt
password string The password for the login attempt

Structure 'faxmailingdestination'

Name Type Description
id string The ID of the destination.

Structure 'smsmailingdestination'

Name Type Description
id string The ID of the destination.

Structure 'emailingdestination'

Name Type Description
id string The ID of the destination.