List mail forwards

Description

List mail forwards for specified domain zone

Parameters

Name	Data Type	Status	Description
auth-id or sub-auth-id or sub-auth-user	Integer	Required	Authentication parameter
auth-password	String	Required	Authentication parameter
domain-name	String	Required	Domain name whose mail forwards you want to see
source	String	Optional	Filter results by the given source mail
destination	String	Optional	Filter results by the given destination mail

Response: Array with mail forwards or failed status and status description.

Errors

When the authenctication of API user is not correct, any API request will fail with the following status and statusDescription:

{"status":"Failed","statusDescription":"Invalid authentication, incorrect auth-id or auth-password."}

In case the credentials of API sub user are invalid, the following status and statusDescription will be returned:

{"status":"Failed","statusDescription":"Invalid authentication, incorrect sub-auth-id, sub-auth-user or auth-password."}

When invalid or non-existant domain-name is entered, the following status will be returned:

{"status":"Failed","statusDescription":"Missing domain-name"}

Note: These are example errors in JSON format.

Example

URL JSON: https://api.cloudns.net/dns/mail-forwards.json
POST/GET:
auth-id=0&auth-password=password&domain-name=domain.com
sub-auth-id=0&auth-password=password&domain-name=domain.com

URL XML: https://api.cloudns.net/dns/mail-forwards.xml
POST/GET:
auth-id=0&auth-password=password&domain-name=domain.com
sub-auth-id=0&auth-password=password&domain-name=domain.com