**Coming end of January 2018**
The Show List Definitions command allows you to return a list of List Definitions in your realm. This command returns the list definition id and name of each list definition in the realm. Show List Definitions requires the following arguments: Command, Realm, and Password.
api_web?r=myrealm&p=mypass&c=getlistdefinitions
The command is ‘getlistdefinitions’, the realm is ‘myrealm’ and the password is ‘mypass’.
Example
Using all commands and arguments, non-verbose (please note the command is wrapped for display purposes only):
api_web?r=myrealm&p=mypass&c=getlistdefinitions&verbose=0&output_format=csv&headers=1
Successful results return:
"List Definition ID","List Definition Name","Description","Folder ID","Lists Defined"
"10","mylistdefinition","","2","(mylist_1,mylist_2,mylist_3)"
"15","automationdefinition","use for automation","5","(welcome,welcome_1,welcome_2)"
If a Description is not defined for a list, it will appear blank or empty in the results.
Results
The Show List Definitions command outputs either the results of the search or a FAILURE message.
Success
The Show List Definitions command does not explicitly return a Success code. Instead, it outputs the list definition id and name in plain text format. Use the output_format argument to return the following data in an alternate format.
Non-verbose results include:
"List Definition ID","List Definition Name","Description","Folder ID","Lists Defined"
Verbose results include:
"List Definition ID","List Definition Name","Description","Folder ID","Lists Defined","Template","AccountProfileId","From Address","Reply To Address","Bounce Address","AdminEmail","ConfirmSubs","ConfirmMessageFrom","ConfirmMessageTemplateId","ConfirmMessageFormat","SendCourtesySubsEmail","CourtesyJoinFrom","SubscribeEmailTemplateId","CourtesyJoinFormat","SendCourtesyUnsubsEmail","CourtesyLeaveFrom","UnsubscribeEmailTemplateId","CourtesyLeaveFormat","DefaultAutomation","DefaultAutomationCampaignId","ConfirmationSubGoto","ConfirmationUnsubGoto","Track Clicks","Track Opens","BaseUrlId","Vmta","FtafCustomFormUrl","FtafCustomEnvelopeUrl","FtafLandingPage","FtafErrorLandingPage","FtafAnonymous","FtafUseListFromAddress","DedupeOnSend","WorkflowApproval","WorkflowApprovalList","ListUnsubscribeHeaderEnabled","UnsubHeaderHttpValue","UnsubHeaderEmailValue","UseStickyCampaign","SetDataMacroId"
Failure
A Show List Definitions command will fail for several reasons. The result format is:
FAILURE: [Reason]
Arguments
The Show List Definitions command supports the following arguments:
Name |
Req? |
Description |
Argument |
Command |
Yes |
Defines the command to use. |
cmd=getlistdefinitions c=getlistdefinitions |
Realm |
Yes |
Name of the realm to run the command. This is required, and the command will fail if the realm and password do not match. |
realm=[realm_name] r=[realm_name] |
Password |
Yes |
Authentication code for API access. This is required, and the command will fail if the realm and password do not match. |
pwd=[password] p=[password] |
Verbose |
|
Return the full set of properties. |
verbose=[0,1] DEFAULT==0 |
Output Format |
|
To specify the format of the list output, use one of two arguments. If no argument is included, the default output is space-delimited plain text string, which may not include all data columns. |
csv=1 or output_format=[csv,csv_tab, csv_pipe,xml] |
Header |
|
To define the data with a label, use the Header argument. This can only be used in conjunction with the output format, and does not affect XML. |
headers=[0,1] DEFAULT==0 |
*Feature released in v13.0.0.