# List all unsubscribes

Paginate over a list of unsubscribes for domain.

Endpoint: GET /v3/{domainID}/unsubscribes
Version: 3.0.0
Security: basicAuth

## Path parameters:

  - `domainID` (string, required)
    The name of the domain you want to get unsubscribes from

## Query parameters:

  - `limit` (integer)
    Maximum number of records to return (optional, default: 100, max: 1000)

  - `page` (string)
    Page direction relative to the above address, can be ,  or , if empty, returns the first page

  - `address` (string, required)
    address serving as a "divider" between pages

  - `term` (string, required)
    Filter records based on addresses that start with the specified substring.

## Response 200 fields (application/json):

  - `items` (array, required)

  - `items.address` (string, required)
    Email address for the original recipient

  - `items.tags` (array, required)
    Any tags present on the message the user clicked Unsubscribe on

  - `items.created_at` (object, required)
    Timestamp for when the unsubscribe request was received in RFC822 format

  - `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 400 fields (application/json):

  - `message` (string, required)
    Response message