---
title: "Get entity domain portfolio"
method: GET
path: "/entities/{name}/portfolio"
tags: ["entities"]
---

# Get entity domain portfolio

`GET /entities/{name}/portfolio`

## Request

- Base URL: `https://api.whoisgeni.us` (the document declares no server; this is the origin it was published from)
- URL: `https://api.whoisgeni.us/entities/{name}/portfolio`
- Auth: none declared

Discover all domains associated with an entity via Reverse WHOIS.

Queries the Reverse WHOIS API to find domains registered
to or associated with the given entity name. Results are capped at 50
domains and cached for 7 days.

Returns HTTP 503 when the Reverse WHOIS service is unavailable or
not configured. This endpoint is independent of the main analysis
pipeline and never degrades analysis performance.

Requires API key authentication via X-API-Key header.

## Path parameters

- `name` string, required: Entity name to query (2-255 chars, no control characters)

## Headers

- `X-API-Key` string, nullable

## Response `200`

Successful Response

- ApiResponsePortfolioResponse
  - `data` PortfolioResponse: Response for the entity portfolio endpoint. Contains the domains associated with an entity via Reverse WHOIS API, capped at 50 results. Attributes: entity_name: The queried entity name. portfolio_count: Total domain count (may exceed len(domains) if > 50). domains: List of domains (up to 50). cached: Whether the result was served from cache. cache_expires_at: ISO 8601 timestamp when cache entry expires, if cached.
    - `entity_name` string, required
    - `portfolio_count` integer, required
    - `domains` PortfolioDomain[], required
      - `domain_name` string, required
    - `cached` boolean, required
    - `cache_expires_at` string, nullable
  - `error` ErrorDetail: Structured error information for API error responses. Attributes: code: Machine-readable error code (e.g. "JOB_NOT_FOUND"). message: Human-readable error description. details: Optional additional context for debugging.
    - `code` string, required
    - `message` string, required
    - `details` object, nullable
  - `meta` object, nullable

## Other responses

- `401`: Unauthorized — missing or invalid API key/JWT.
- `422`: Validation Error

---

[API](https://skmtc.dev/whoisgeni/apis/whoisgenius.md) · [All operations](https://skmtc.dev/whoisgeni/apis/whoisgenius/llms.txt) · [OpenAPI document](https://skmtc.dev/whoisgeni/apis/whoisgenius/revisions/707f1c34f6b3?raw)