---
title: "Search domains by name or host"
method: GET
path: "/api/domains/lookup"
tags: ["domains"]
---

# Search domains by name or host

`GET /api/domains/lookup`

## Request

- Base URL: `https://api-v1.unusual.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api-v1.unusual.ai/api/domains/lookup`
- Auth: OAuth 2
  - Password
  - Token URL: `/auth/login`

Paginated domain search. Returns total count, has_more flag, and matching results. Use limit/offset to page.

## Query parameters

- `q` string: Search string (case-insensitive partial match on name or host). Empty returns all.
- `limit` integer: Max results to return
- `offset` integer: Number of results to skip
- `org_id` string, nullable

## Headers

- `x-view-as` string, nullable

## Response `200`

Successful Response

- DomainLookupResponse
  - `total` integer, required
  - `has_more` boolean, required
  - `results` DomainLookupResult[], required
    - `id` string, required
    - `name` string, nullable, required
    - `host` string, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/unusual/apis/dashboard-server.md) - [All operations](https://skmtc.dev/unusual/apis/dashboard-server/llms.txt) - [OpenAPI document](https://skmtc.dev/unusual/apis/dashboard-server/revisions/89f716930ead?raw)