Beta — may change; breaking changes are coordinated with affected
customers. Suitable for evaluation, not production reliance.

Lists services, one row per service, each carrying a closed RED metrics
snapshot under redMetrics. Filters are exact-match on serviceName,
environment, serviceNamespace, and serviceType; an omitted filter
matches every value of that dimension. Omit serviceType to return
every catalog type (Service, Database, Messaging). External
values are not catalog types (400).
When serviceType is omitted and
serviceName is set, the name matches service.name OR peer.db.name
OR peer.messaging.system.

When expand=true, each row's redMetrics.series[] additionally
carries a per-bucket time series across the query window; read the
bucket cadence from the spacing between consecutive
series[].timestamp. When expand is false or omitted, series is
absent (not null, not an empty array).

Zero matches return 200 with services: [] and meta.totalCount: 0.
meta.totalCount is -1 when an exact count is too expensive to
compute; in that case paginate by advancing offset until a page
shorter than limit is returned.

Response size grows with the number of rows on the page and, when
expand=true, with the number of series points per row. A wide window
combined with expand=true can therefore make a single page exceed the
server response-size limit and return 413 PayloadTooLarge. Recover by
narrowing the time window or requesting a smaller limit. limit is
never rejected for being too large: it is clamped to its maximum
server-side, and to a lower maximum when expand=true.