SearchPayloadBulkLookupRequest

object
bulk_lookupobjectrequired

Bulk lookup of entities matching the values.

Show Child Parameters
Example

SearchPayloadBulkLookup

object

Bulk lookup of entities matching the values.

typestringrequired

The entity type.

filtersarray[object]required

The values to lookup.

>= 1 items<= 1000 items

Example

SearchMode

string

The mode of search to perform. Basic search is a simple keyword search that matches the query against all searchable fields. Advanced search allows lucene-like syntax for filtering results, including logical operators and field-specific searches.

Allowed values:basicadvanced

Default:advanced

Relation

object
typestringrequired

The type of the related entity.

idstringrequired

The unique identifier of the related entity.

child_relationsarray[object]required

The child relations of the related entity.

Show Child Parameters
Example

PlatformAggregateRequest

object

Pre-release Feature
This feature is currently in beta and is subject to change.

entity_typesarray[string]required

Entity types to count. When group_by is set, only one entity type is allowed.

Allowed values:control_planegateway_servicerouteconsumerplugindata_plane_node

>= 1 items

query_typestring

Optional. When omitted, returns current counts only (no comparison or time bucketing).
When trend, start and end are required. When time_series, start, end, and interval are required.

Allowed values:trendtime_series

startstring(date-time)

Start of the time range (inclusive). Required when query_type is set. ISO 8601 UTC datetime.

Example:2026-02-21T00:00:00.000Z

endstring(date-time)

End of the time range (inclusive). Required when query_type is set. ISO 8601 UTC datetime.

Example:2026-03-23T00:00:00.000Z

intervalstring

Bucket interval. Required when query_type=time_series.

Allowed values:1d1w1M1q1y

group_bystring

Dimension to group results by. Available dimensions depend on entity_type:
control_plane → (none), gateway_service → control_plane,
route → control_plane | gateway_service,
consumer → control_plane | realm,
plugin → control_plane | plugin_name | plugin_scope,
data_plane_node → control_plane | data_plane_node_version.

Allowed values:control_planegateway_servicerealmplugin_nameplugin_scopedata_plane_node_version

filtersarray[object]

Optional filters. Dimensions available for filtering match those available for group_by.

Show Child Parameters
Example