# List Email Forwardings

Returns a paginated list of all email forwarding rules for a domain.

Endpoint: GET /core/v1/domains/{domainName}/email/forwarding
Version: 1.3.1
Security: BasicAuth

## Path parameters:

  - `domainName` (string, required)
    DomainName is the domain to list email forwarded boxes for.

## Query parameters:

  - `perPage` (integer)
    (optional) Per Page is the number of records to return per request. Per Page defaults to 1,000 if not set.
    Example: 100

  - `page` (integer)
    (optional) Page is which page to return. Default to page 1 if not set.
    Example: 1

## Response 200 fields (application/json):

  - `emailForwarding` (array, required)
    EmailForwarding is the list of forwarded email boxes.

  - `emailForwarding.domainName` (string, required)
    DomainName is the domain part of the email address to forward.
    Example: "example.com"

  - `emailForwarding.emailBox` (string, required)
    EmailBox is the user portion of the email address to forward.
    Example: "admin"

  - `emailForwarding.emailTo` (string, required)
    EmailTo is the entire email address to forward email to.
    Example: "webmaster@example.com"

  - `lastPage` (integer)
    LastPage is the identifier for the final page of results. It is only populated if there is another page of results after the current page.

  - `nextPage` (integer)
    NextPage is the identifier for the next page of results. It is only populated if there is another page of results after the current page.

## Response 429 fields (application/json):

  - `message` (string)
    A human-readable message providing more details about the error
    Example: "Rate Limit Exceeded"

## Response 500 fields (application/json):

  - `message` (string, required)
    A human-readable message providing more details about the error.
    Example: "Internal Server Error"

  - `details` (string,null)
    Additional context or information about the error.
    Example: "Something went wrong."