# List allowlist records for domain

Paginate over  all allowlist records for a domain.

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

## Path parameters:

  - `domainID` (string, required)
    The name of the domain you want to get allowlist 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.type` (string, required)
    Type of allowlist

  - `items.value` (string, required)
    Domain or address allowlisted

  - `items.createdAt` (object, required)
    Timestamp for when the entry was created in RFC822 format

  - `items.reason` (string, required)
    User-provided reason for allowlisting

  - `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