Retrieve Multiple Taxonomies

Retrieve all taxonomies in the space.

GET

https://api.storyblok.com/v2/cdn/taxonomies

Query parameters

token required string
A preview or public access token configured in a space.

Response properties

taxonomies array<TaxonomyTerm>
Show child properties
- id string
  The taxonomy’s ID.
- display_name string
  The taxonomy’s name.
- name string
  The taxonomy’s technical name.
- description string | null
  The taxonomy’s description.
- parent_id string | null
  The top-level term’s ID.
- last_author object | null
  An object that contains the details of user who created the term.
  Show child properties
  id integer
  The user’s numeric ID.
  userid string
  The user’s username or email address.
  friendly_name string
  The user’s display name.
  avatar string | null
  The URL of the user’s avatar image.
- last_author_id string | null
  The user’s ID.
- created_at string
  Creation timestamp. Supports ISO 8601.
- updated_at string
  Latest update timestamp. Supports ISO 8601.
- children array<TaxonomyTerm>
  An array of sub-terms objects.
  Show child properties
  id string
  The taxonomy’s ID.
  display_name string
  The taxonomy’s name.
  name string
  The taxonomy’s technical name.
  description string | null
  The taxonomy’s description.
  parent_id string | null
  The top-level term’s ID.
  last_author object | null
  An object that contains the details of user who created the term.
  Show child properties
  id integer
  The user’s numeric ID.
  userid string
  The user’s username or email address.
  friendly_name string
  The user’s display name.
  avatar string | null
  The URL of the user’s avatar image.
  last_author_id string | null
  The user’s ID.
  created_at string
  Creation timestamp. Supports ISO 8601.
  updated_at string
  Latest update timestamp. Supports ISO 8601.
  children array<TaxonomyTerm>
  An array of sub-terms objects.
  terms_count integer
  The number sub-terms (at any depth).
  last_activity_at string
  Latest update timestamp. Supports ISO 8601.
  associated_content array<object>
  An array of story objects associated with the taxonomy.
  Show child properties
  id string
  The associated story’s ID.
  type string
  The associated block type’s name.
  name string
  full_slug string
  The story’s full slug, including parent folder and language paths.
  updated_at string
  Latest update timestamp. Supports ISO 8601.
- terms_count integer
  The number sub-terms (at any depth).
- last_activity_at string
  Latest update timestamp. Supports ISO 8601.
- associated_content array<object>
  An array of story objects associated with the taxonomy.
  Show child properties
  id string
  The associated story’s ID.
  type string
  The associated block type’s name.
  name string
  full_slug string
  The story’s full slug, including parent folder and language paths.
  updated_at string
  Latest update timestamp. Supports ISO 8601.
cv integer | null

Examples

curl "https://api.storyblok.com/v2/cdn/taxonomies\
?token=ask9soUkv02QqbZgmZdeDAtt"

// storyblok-js-client@>=7, node@>=18
import Storyblok from "storyblok-js-client";

const storyblok = new Storyblok({
  accessToken: "krcV6QGxWORpYLUWt12xKQtt",
});

try {
  const response = await storyblok.get('cdn/taxonomies', {})
  console.log({ response })
} catch (error) {
  console.log(error)
}

$client = new \Storyblok\Client('YOUR_STORYBLOK_SPACE_ACCESS_TOKEN');

$client->get('taxonomies')->getBody();

HttpResponse<String> response = Unirest.get("https://api.storyblok.com/v2/cdn/taxonomies?token=ask9soUkv02QqbZgmZdeDAtt")
  .asString();

var client = new RestClient("https://api.storyblok.com/v2/cdn/taxonomies?token=ask9soUkv02QqbZgmZdeDAtt");
var request = new RestRequest(Method.GET);

IRestResponse response = client.Execute(request);

import requests

url = "https://api.storyblok.com/v2/cdn/taxonomies"

querystring = {"token":"ask9soUkv02QqbZgmZdeDAtt"}

payload = ""
headers = {}

response = requests.request("GET", url, data=payload, headers=headers, params=querystring)

print(response.text)

require 'storyblok'
client = Storyblok::Client.new(token: 'YOUR_TOKEN')

client.get('taxonomies')

let storyblok = URLSession(storyblok: .cdn(accessToken: "ask9soUkv02QqbZgmZdeDAtt"))
let request = URLRequest(storyblok: storyblok, path: "taxonomies")
let (data, _) = try await storyblok.data(for: request)
print(try JSONSerialization.jsonObject(with: data))

val client = HttpClient {
    install(Storyblok(CDN)) {
        accessToken = "ask9soUkv02QqbZgmZdeDAtt"
    }
}

val response = client.get("taxonomies")

println(response.body<JsonElement>())

Was this page helpful?

This site uses reCAPTCHA and Google's Privacy Policy (opens in a new window).Terms of Service (opens in a new window) apply.

Get in touch with the Storyblok community

Cookie notice

Retrieve Multiple Taxonomies

Query parameters

Response properties

Examples