---
title: "GET /v1/datasets/{id}/fields"
method: GET
path: "/v1/datasets/{id}/fields"
---

# GET /v1/datasets/{id}/fields

`GET /v1/datasets/{id}/fields`

## Request

- Base URL: `https://api.servicegraph.co`
- URL: `https://api.servicegraph.co/v1/datasets/{id}/fields`
- Auth: HTTP bearer

Filter field catalog for one dataset: name + kind + operators + description for every field the dataset's /search will accept. Default response omits value lists; pass include_values=1 to expand them inline (cheap for short enums, slow for service_provided). For longer enums prefer /v1/datasets/:id/values/:field. Also returns the DSL grammar string so an agent can prime a single session with one call.

## Path parameters

- `id` string, required

## Query parameters

- `q` string
- `include_values` '0' | '1'

## Response `200`

Default Response

---

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