# Run email delivery route trace

This function traces the email delivery route to an email account.

Endpoint: GET /Email/trace_delivery
Version: 11.134.0.5
Security: BasicAuth

## Query parameters:

  - `recipient` (string, required)
    The email address to which to trace a message delivery path.
    Example: "username@example.com"

## Response 200 fields (application/json):

  - `apiversion` (integer)
    The version of the API.
    Example: 3

  - `func` (string)
    The name of the method called.
    Example: "trace_delivery"

  - `module` (string)
    The name of the module called.
    Example: "Email"

  - `result` (object)

  - `result.data` (object)
    Example: {"address":"username@example.com","destinations":[{"address":"username@example.com","aliasfile":"/etc/valiases/example.com","destinations":[{"mailbox":"username@example.com","type":"local_delivery"}],"type":"routed"}],"type":"routed"}

  - `result.data.address` (string)
    The email address of an email message recipient.
    Example: "username@example.com"

  - `result.data.type` (string)
    A type of trace node. The system returns this value to indicate the  of routing.
*  - The system rejected the email's delivery.
*  - The system will run a command when it receives an email.
*  - The system deferred the email.
*  - The system discarded the email.
*  - The system encountered an error.
*  - The system sent the email to a local mailbox.
*  - The system sent the email via Simple Mail Transfer Protocol (SMTP).
*  - The system routed the email elsewhere.


* The structure of the  return changes depending on the  return value.
* The  type can return any other type's data structure as part of the  return value.

For more information, see the return structure for each  return value below:
    Example: "routed"

  - `result.errors` (array,null)
    List of errors if the API failed.

  - `result.messages` (array,null)
    List of messages generated by the API.

  - `result.metadata` (object)

  - `result.status` (integer)
    *  - Success
*  - Failed: Check the errors field for more details.
    Enum: 0, 1

  - `result.warnings` (array,null)
    List of warnings generated by the API. Warnings
 describe non-critical failures or other problematic conditions
 noted while running a API.