---
title: "List Metadata Fields"
method: GET
path: "/datasets/{dataset_id}/metadata"
tags: ["Metadata"]
---

# List Metadata Fields

`GET /datasets/{dataset_id}/metadata`

Returns all metadata fields for the knowledge base, both custom and built-in, with the count of documents using each field.

## Path parameters

- `dataset_id` string, uuid, required

## Response `200`

Metadata fields for the knowledge base.

- object
  - `doc_metadata` object[] — List of metadata field definitions.
    - `id` string — Metadata field identifier.
    - `name` string — Metadata field name.
    - `type` string — Metadata field type.
    - `count` integer — Number of documents using this metadata field.
  - `built_in_field_enabled` boolean — Whether built-in metadata fields are enabled for this knowledge base.

## Other responses

- `403` — `forbidden` : Dataset api access is not enabled.
- `404` — `not_found` : Dataset not found.

---

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