---
title: "GET /v1/hosts/"
method: GET
path: "/v1/hosts/"
tags: ["Hosts"]
---

# GET /v1/hosts/

`GET /v1/hosts/`

## Request

- Base URL: `https://api.redirectboss.com`
- URL: `https://api.redirectboss.com/v1/hosts/`
- Auth: API key in header `X-Api-Key`

List all hosts, with optional search and pagination.

## Query parameters

- `offset` integer
- `limit` integer
- `orderBy` 'host' | 'dnsLastCheckedAt' | 'dnsStateLastChangedAt' | 'sslEnabledAt' | 'createdAt' | 'updatedAt'
- `orderDir` 'ASC' | 'DESC'
- `search` string
- `isSslEnabled` boolean
- `isDnsResolving` boolean

## Response `200`

Default Response

- object
  - `data` object[], required
    - `id` string, uuid: Unique host identifier
    - `host` string, hostname: The domain name (e.g. "example.com")
    - `handleWww` boolean: Whether the www subdomain is also handled (e.g. www.example.com)
    - `isDnsResolving` boolean: Whether the apex domain DNS is resolving to our servers. Null if not yet checked.
    - `dnsLastCheckedAt` string, date-time: When DNS resolution was last verified. Null if not yet checked.
    - `sslEnabledAt` string, date-time: When SSL was enabled for the apex domain. Null if SSL is not enabled.
    - `wwwSslEnabledAt` string, date-time: When SSL was enabled for the www subdomain. Null if SSL is not enabled.
    - `wwwDnsResolving` boolean: Whether the www subdomain DNS is resolving to our servers. Null if not yet checked.
    - `createdAt` string, date-time: When the host was created
    - `updatedAt` string, date-time: When the host was last updated
  - `meta` object, required
    - `requestId` string: Unique identifier for this request
  - `pagination` object, required
    - `offset` integer: Starting position in the result set
    - `limit` integer: Maximum number of items returned per page
    - `total` integer: Total number of items matching the query
    - `totalPages` integer: Total number of pages available
    - `hasNext` boolean: Whether there is a next page of results
    - `hasPrev` boolean: Whether there is a previous page of results

## Other responses

- `429`: Default Response

---

[API](https://skmtc.dev/redirectboss/apis/redirectboss-api.md) · [All operations](https://skmtc.dev/redirectboss/apis/redirectboss-api/llms.txt) · [OpenAPI document](https://skmtc.dev/redirectboss/apis/redirectboss-api/revisions/0159ad2b68fa?raw)