employee, user, or
third_party so you can prioritize corporate-account compromises.
Request
POST /v1/domain/company · Required scope: search:domain (all tiers)
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
domains | string[] | Yes | — | Primary company domains, min 1 item. e.g. ["acme-corp.com"] |
external_domains | string[] | No | [] | SSO/IdP or other external app domains, e.g. ["acme-corp.okta.com"] — logins here are classified employee too |
type | employees | users | both | No | both | See Overview |
start_date | string (date-time) | null | No | — | Inclusive start filter, clamped by query_window_days |
end_date | string (date-time) | null | No | — | Inclusive end filter |
sort_direction | asc | desc | No | desc | Must stay constant across pages |
cursor | string | null | No | — | Pagination token |
limit | integer | No | 25 | 1–500, clamped to your tier’s max_rows |
Example request
Response
200 OK — array of DomainCompanyResult (a DomainSearchResult plus
credential_type), cursor-paginated.
| Field | Description |
|---|---|
credential_type | employee — login belongs to domains or external_domains; user — external account on a domains URL; third_party — neither, but co-present on the same infected machine |
DomainSearchResult.
Pagination
Cursor-paginated — see Pagination.Errors
| Status | code | Cause |
|---|---|---|
| 400 | VALIDATION_ERROR | domains is empty or exceeds limits |
| 400 | INVALID_CURSOR | Tampered or stale cursor |
| 403 | FORBIDDEN_SCOPE | Key lacks search:domain |