---
title: "List service field values"
method: GET
path: "/api/v1/services/field-values/{field}"
tags: ["Services", "internal"]
---

# List service field values

`GET /api/v1/services/field-values/{field}`

## Request

- Base URL: `https://app.scanopy.net`
- URL: `https://app.scanopy.net/api/v1/services/field-values/{field}`
- Auth: one of:
  - API key in header `Authorization`
  - API key in cookie `session_id`

Every distinct value of one Service field across the Services the caller can list, with how many hold each. Takes the list's filters; ignores pagination, search and ordering.

## Path parameters

- `field` 'created_at' | 'name' | 'updated_at' | 'host' | 'site_id' | 'position' | 'service_definition' | 'last_seen_at' | 'containerized_by' | 'match_confidence' | 'source', required: Fields that services can be ordered/grouped by.

## Query parameters

- `site_ids` string[], nullable
- `host_ids` string[], nullable
- `ids` string[], nullable
- `service_definitions` string[], nullable
- `virtualization_service_ids` string[], nullable
- `virtualization_service_names` string[], nullable
- `include_uncontainerized` boolean, nullable
- `sources` EntitySourceDiscriminants[], nullable
- `match_confidences` MatchConfidence[], nullable
- `guest_states` GuestState[], nullable
- `tag_ids` string[], nullable
- `tag_sets` string[], nullable
- `search` string, nullable
- `group_by` 'created_at' | 'name' | 'updated_at' | 'host' | 'site_id' | 'position' | 'service_definition' | 'last_seen_at' | 'containerized_by' | 'match_confidence' | 'source': Fields that services can be ordered/grouped by.
- `order_by` 'created_at' | 'name' | 'updated_at' | 'host' | 'site_id' | 'position' | 'service_definition' | 'last_seen_at' | 'containerized_by' | 'match_confidence' | 'source': Fields that services can be ordered/grouped by.
- `group_by_tag_group` string, uuid, nullable
- `order_by_tag_group` string, uuid, nullable
- `order_direction` 'asc' | 'desc': Direction for ORDER BY clauses.
- `ports` integer[], nullable
- `exclude_categories` ServiceCategory[], nullable
- `limit` integer, nullable
- `offset` integer, nullable
- `at` string, date-time, nullable
- `stale` boolean, nullable

## Response `200`

Distinct values and their Service counts

- ApiResponseVecGroupCount: Envelope for a successful response. Failures are sent with a non-2xx status and an `ApiErrorResponse` body instead.
  - `data` object[]: The result payload. Omitted on failure.
    - `count` integer, required: How many rows fall in this group in total, not just on this page.
    - `value` string, nullable: The group's value, rendered as text. `null` for rows whose group key is NULL (the "ungrouped" bucket).
  - `error` string, nullable: Not sent on a successful response. Failure messages arrive in an `ApiErrorResponse`.
  - `meta` ApiMeta, required: API metadata included in all responses
    - `api_version` integer, required: API version (integer, increments on breaking changes)
    - `server_version` string, required: Server version (semver)
  - `success` boolean, required: Always `true` on a successful response.

## Other responses

- `400`: Unknown field

## Changes

- **2026-10-26** `c9d9d46d1ae8`: 1 info
  - api tag `internal` added
- **2026-10-23** `b84d22dad539`: 1 info
  - added the new optional `query` request parameter `guest_states`
- **2026-10-11** `fb5e0436b49e`: 3 info
  - added the new optional `query` request parameter `group_by_tag_group`
  - added the new optional `query` request parameter `order_by_tag_group`
  - added the new optional `query` request parameter `tag_sets`
- **2026-10-11** `a6ea2ab6fbb9`: 3 breaking, 1 warning, 4 info
  - removed the enum value `network_id` from the `path` request parameter `field`
  - removed the enum value `network_id` from the property `oneOf[#/components/schemas/ServiceOrderField]/` of the `query` request parameter `group_by`
  - removed the enum value `network_id` from the property `oneOf[#/components/schemas/ServiceOrderField]/` of the `query` request parameter `order_by`
  - deleted the `query` request parameter `network_ids`
  - …4 more
- **2026-10-11** `308275bffa1b`: 1 info
  - added the enum value `NetworkIdentities` to the property `items/` of the `query` request parameter `exclude_categories`

[Operation history](https://skmtc.dev/scanopy/apis/scanopy-api/changes/api/v1/services/field-values/:field/get.md)

---

[API](https://skmtc.dev/scanopy/apis/scanopy-api.md) - [All operations](https://skmtc.dev/scanopy/apis/scanopy-api/llms.txt) - [OpenAPI document](https://skmtc.dev/scanopy/apis/scanopy-api/revisions/966ba786bdb5?raw)