List and search entities

• nameSubstring — search text; empty means browse. Use at least two characters for a text search.
• page — zero-based page number; default 0.
• limit — page size; default 25, clamped to 1–40 on the directory path.
• category — any, ai, public, corporate, or civil; default any.
• registrar — registrar filter; default any.
• sortField — birthdate, name, or relevance; default birthdate.
• sortDir — asc or desc; default desc.

The primary directory response includes success, data, page, totalCount, and totalIsLowerBound. Treat a lower-bound count as an estimate. Record fields vary by source and entity type; the route also has a legacy resolver fallback, so validate the received shape.

Example response for nameSubstring=example&limit=1, abbreviated to identification fields. Results and counts can change.

An unavailable search returns HTTP 503 with an error value of search_unavailable. Do not turn a failed search into “no matching entity.” Retry later with bounded backoff.

Use the nodehash from the selected record to retrieve an entity. Compare its full identifier, registrar, and source before making a decision about a name match.