List connected hostnames

Every hostname connected to the workspace, with the configuration the edge uses to serve it. Start here before creating records — a hostname has to exist before a link or redirect can point at it.

Base URL: https://api.redirhub.com/v1
Auth: Bearer token
Idempotent: Yes
Returns: application/json

The request

Call GET /host with your bearer token.

# List connected hostnames
curl "https://api.redirhub.com/v1/host" \
  -H "Authorization: Bearer $REDIRHUB_TOKEN"

The response

A 200 carries the payload inside a data array — the same shape the list endpoints return, so one parser handles both.

{
  "data": [
    {
      "host": "go.acme.com",
      "domain": "string",
      "correct": true,
      "default_require": "ip",
      "require": [
        "string"
      ],
      "current": [
        {
          "type": "link",
          "value": "string",
          "line": "string"
        }
      ],
      "errors": [
        {
          "scope": "string",
          "message": "The given data was invalid.",
          "updated_at": "2026-08-01T09:14:22Z"
        }
      ],
      "counts": [
        "string"
      ],
      "https_requested": true,
      "short_links_enabled": true,
      "public": true,
      "notice": "string",
      "checked_at": "string",
      "created_at": "2026-08-01T09:14:22Z",
      "updated_at": "2026-08-01T09:14:22Z"
    }
  ],
  "meta": {
    "cursor": {
      "current": null,
      "prev": "string",
      "next": "string",
      "count": 1
    }
  }
}

Status codes

200

SuccessA cursor-paginated page of hostnames. Follow meta.cursor.next for the next page.

401

UnauthenticatedUnauthenticated

429

Too many requestsToo many requests

What usually comes next

One call is rarely the whole job. These are the endpoints most integrations reach for around this one.

What usually comes nextPOST /link