v62

latestOpenAPI 3.1.0Dual (AGPL3.0, Commercial License Available)raw.githubusercontent.com2026-08-03211303932.5 KB
Services

Export Services to CSV

Export all Services matching the filter criteria to CSV format. Ignores pagination parameters (limit/offset) and exports all matching records.

get/api/v1/services/export/csv

Query parameters

network_idstring uuid nullable

Filter by network ID

host_idstring uuid nullable

Filter by host ID

idsstring[] nullable

Filter by specific entity IDs (for selective loading)

tag_idsstring[] nullable

Filter by tag IDs (returns services that have ANY of the specified tags)

searchstring nullable

Free-text search. Case-insensitive substring match against the service's name and definition, and against the name of the host it runs on.

group_by'created_at' | 'name' | 'updated_at' | 'host' | 'network_id' | 'position' | 'service_definition' | 'last_seen_at'

Fields that services can be ordered/grouped by.

Primary ordering field (used for grouping). Always sorts ASC to keep groups together.

order_by'created_at' | 'name' | 'updated_at' | 'host' | 'network_id' | 'position' | 'service_definition' | 'last_seen_at'

Fields that services can be ordered/grouped by.

Secondary ordering field (sorting within groups or standalone sort).

order_direction'asc' | 'desc'

Direction for ORDER BY clauses.

Direction for order_by field (group_by always uses ASC).

portsinteger[] nullable

Only services exposed on one of these port numbers, over either protocol.

exclude_categoriesServiceCategory[] nullable

Exclude services belonging to these categories.

limitinteger nullable

Maximum number of results to return (1-1000, default: 50). Use 0 for no limit.

offsetinteger nullable

Number of results to skip. Default: 0.

atstring date-time nullable

As-of timestamp (ISO 8601). When set, returns SCD2 state as of this instant (snapshot view) instead of live state.

staleboolean nullable

true returns only services discovery hasn't observed within their network's staleness window; false returns only those it has. Omit for both. Evaluated per row against the service's own network's window.

Response

CSV file containing Services