Taxonomy
Taxonomy, simplifies the process of organizing content in your system, making it effortless to find and retrieve information. It allows you to arrange your web properties in a hierarchy according to your specific needs, whether it's their purpose, intended audience, or other aspects of your business.
NoteRefer to the Taxonomy Queries section for more query filters.
Get all taxonomies
https://cdn.contentstack.io/v3/taxonomiesThe Get all taxonomies request retrieves all published taxonomies for the given environment.
{
"taxonomies": [
{
"uid": "categories",
"name": "Categories",
"description": "All categories for products.",
"publish_details": {
"time": "2025-09-01T13:19:28.365Z",
"user": "blt368bfe4e50023d0e",
"environment": "bltd7f8cacaf649b485",
"locale": "en-us"
}
}
],
"count": 1
}Get a single taxonomy
https://cdn.contentstack.io/v3/taxonomies/{taxonomy_uid}The Get a single taxonomy request retrieves details of a single published taxonomy.
{
"taxonomy": {
"uid": "categories",
"name": "Categories",
"description": "All categories for products.",
"publish_details": {
"time": "2025-09-01T13:19:28.365Z",
"user": "blt368bfe4e50023d0e",
"environment": "bltd7f8cacaf649b485",
"locale": "en-us"
}
}
}Get all terms
https://cdn.contentstack.io/v3/taxonomies/{taxonomy_uid}/termsThe Get all terms request retrieves all published terms in a taxonomy for the specified environment and locale.
{
"terms": [
{
"uid": "california",
"name": "California",
"parent_uid": "usa",
"taxonomy_uid": "regions",
"order": 1,
"locale": "en-us",
"created_at": "2024-02-01T10:30:00.000Z",
"updated_at": "2024-02-01T10:30:00.000Z",
"created_by": "admin",
"updated_by": "admin"
}
],
"count": 1
}Get a single term
https://cdn.contentstack.io/v3/taxonomies/{taxonomy_uid}/terms/{term_uid}The Get a single term request retrieves a specific published term within a taxonomy.
{
"term": {
"uid": "gaming_laptops",
"name": "Gaming Laptops",
"parent_uid": "laptops",
"order": 1,
"locale": "en-us",
"publish_details": {
"time": "2025-09-01T13:19:28.365Z",
"user": "blt368bfe4e50023d0e",
"environment": "bltd7f8cacaf649b485",
"locale": "en-us"
}
}
}Get a single term in all locales
https://cdn.contentstack.io/v3/taxonomies/{taxonomy_uid}/terms/{term_uid}/localesThe Get a single term in all locales request retrieves all localized versions of a published term.
{
"terms": [
{
"uid": "gaming_laptops",
"name": "Gaming Laptops",
"locale": "en-us",
"publish_details": {
"time": "2025-09-01T13:19:28.365Z",
"user": "blt368bfe4e50023d0e",
"environment": "bltd7f8cacaf649b485",
"locale": "en-us"
}
},
{
"uid": "gaming_laptops",
"name": "Ordinateurs Portables de Jeu",
"locale": "fr-fr",
"publish_details": {
"time": "2025-09-01T13:25:00.000Z",
"user": "blt368bfe4e50023d0e",
"environment": "bltd7f8cacaf649b485",
"locale": "fr-fr"
}
}
]
}Get descendants of a term
https://cdn.contentstack.io/v3/taxonomies/{taxonomy_uid}/terms/{term_uid}/descendantsThe Get descendants of a term request retrieves all descendant terms of a given term.
{
"term": {
"uid": "electronics",
"name": "Electronics",
"parent_uid": null,
"order": 1,
"locale": "en-us",
"descendants": [
{
"uid": "laptops",
"name": "Laptops",
"parent_uid": "electronics",
"order": 1,
"locale": "en-us"
}
]
}
}Get ancestors of a term
https://cdn.contentstack.io/v3/taxonomies/{taxonomy_uid}/terms/{term_uid}/ancestorsThe Get ancestors of a term request retrieves all ancestor terms of a given term up to the root.
{
"term": {
"uid": "gaming_laptops",
"name": "Gaming Laptops",
"parent_uid": "laptops",
"order": 1,
"locale": "en-us",
"ancestors": [
{
"uid": "laptops",
"name": "Laptops",
"parent_uid": "electronics",
"order": 1,
"locale": "en-us"
},
{
"uid":"electronics",
"name": "Electronics",
"parent_uid": null,
"order": 1,
"locale": "en-us"
}
]
}
}