---
title: "List taxonomy-capable fields"
method: GET
path: "/v1/taxonomy/fields"
tags: ["Taxonomy"]
---

# List taxonomy-capable fields

`GET /v1/taxonomy/fields`

Returns the feedback fields that can be used to generate a taxonomy for a tenant, along with the
number of text records and embedded records available per field scope (source_type, source_id,
field_id). A field with no attributed source is exposed under the canonical "no source" bucket
(empty source_id). Requires Hub embeddings to be configured; otherwise the endpoint returns 503.

## Query parameters

- `tenant_id` string, required

## Response `200`

Taxonomy-capable fields

- TaxonomyFieldsOutputBody
  - `data` TaxonomyFieldOption[], required
    - `tenant_id` string, required
    - `source_type` string, required
    - `source_id` string, required — Empty string is the canonical "no source" bucket.
    - `source_name` string
    - `field_id` string, required
    - `field_label` string
    - `record_count` integer, required — Number of text feedback records in the scope.
    - `embedding_count` integer, required — Number of those records that have an embedding.

## Other responses

- `400` — Bad Request (e.g. missing or invalid tenant_id)
- `401` — Unauthorized (missing or invalid API key)
- `503` — Service Unavailable – Hub embeddings are not configured, so taxonomy is unavailable (code `service_unavailable`). Retry once embeddings are enabled.
- `default` — Error

---

[API](https://skmtc.net/formbricks/apis/formbricks-hub-api.md) · [All operations](https://skmtc.net/formbricks/apis/formbricks-hub-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/formbricks/formbricks-hub-api/revisions/8d06d9728138/schema)