---
title: "Retrieve a Single Taxonomy Term"
method: GET
path: "/v2/cdn/taxonomy_terms/{id}"
tags: ["Taxonomy Terms"]
---

# Retrieve a Single Taxonomy Term

`GET /v2/cdn/taxonomy_terms/{id}`

## Request

- Base URL: `https://api.storyblok.com`
- URL: `https://api.storyblok.com/v2/cdn/taxonomy_terms/{id}`
- Auth: API key in query parameter `token`
- TypeScript: <https://skmtc.dev/storyblok/apis/storyblok-content-delivery-api/docs/v2/cdn/taxonomy_terms/:id/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve a single taxonomy term and its sub-terms.

## Response `200`

Term retrieved

- object
  - `taxonomy_term` TaxonomyTerm, required: An object that contains a taxonomy.
    - `id` string, required: The taxonomy’s ID.
    - `display_name` string, required: The taxonomy’s name.
    - `name` string, required: The taxonomy’s technical name.
    - `description` string, nullable, required: The taxonomy’s description.
    - `parent_id` string, nullable, required: The top-level term’s ID.
    - `last_author` object, nullable, required: An object that contains the details of user who created the term.
      - `id` integer, required: The user’s numeric ID.
      - `userid` string, required: The user’s username or email address.
      - `friendly_name` string, required: The user’s display name.
      - `avatar` string, nullable: The URL of the user’s avatar image.
    - `last_author_id` string, nullable, required: The user’s ID.
    - `created_at` string, date-time, required: Creation timestamp. Supports ISO 8601.
    - `updated_at` string, date-time, required: Latest update timestamp. Supports ISO 8601.
    - `children` TaxonomyTerm[]: An array of sub-terms objects.
    - `terms_count` integer: The number sub-terms (at any depth).
    - `last_activity_at` string, date-time: Latest update timestamp. Supports ISO 8601.
    - `associated_content` object[]: An array of story objects associated with the taxonomy.
      - `id` string, required: The associated story’s ID.
      - `type` 'Story', required: The associated block type’s name.
      - `name` string, required
      - `full_slug` string: The story’s full slug, including parent folder and language paths.
      - `updated_at` string, date-time, required: Latest update timestamp. Supports ISO 8601.
  - `cv` integer, nullable, required: Cached version Unix timestamp. Learn more in the [Caching concept](https://www.storyblok.com/docs/concepts/caching).

## Other responses

- `401`: Unauthorized
- `403`: The c19-taxonomy feature is unavailable
- `404`: Term not found
- `429`: Rate limit reached

---

[API](https://skmtc.dev/storyblok/apis/storyblok-content-delivery-api.md) - [All operations](https://skmtc.dev/storyblok/apis/storyblok-content-delivery-api/llms.txt) - [OpenAPI document](https://skmtc.dev/storyblok/apis/storyblok-content-delivery-api/revisions/6981ed842964?raw)