# List forward rules

By default this endpoint lists all rules defined on the account. You can scope the list of rules by domain by providing the 'domain.name' query parameter.

Endpoint: GET /v3/forwards
Version: 3.0.0
Security: basicAuth

## Query parameters:

  - `page` (string, required)
    Encoded paging information, provided via 'next', 'previous' links

  - `limit` (integer, required)
    Limits the number of items returned in a request

  - `domain.name` (string)
    The name of the domain the rule is scoped to

## Response 200 fields (application/json):

  - `items` (array, required)

  - `items.id` (string, required)

  - `items.account_id` (string, required)

  - `items.domain_name` (string, required)

  - `items.domain_id` (string, required)

  - `items.match` (string, required)

  - `items.forward` (object, required)

  - `items.forward.urls` (array, required)

  - `items.forward.recipients` (array)

  - `items.forward.store` (string)

  - `items.created_at` (string, required)

  - `items.updated_at` (string, required)

  - `paging` (object, required)

  - `paging.previous` (string, required)
    Previous page URL

  - `paging.first` (string, required)
    First page URL

  - `paging.next` (string, required)
    Next page URL

  - `paging.last` (string, required)
    Last page URL

## Response 401 fields (application/json):

  - `message` (string, required)
    Response message

## Response 500 fields (application/json):

  - `message` (string, required)
    Response message