Jump to

• Request
• Response
• Examples

List taxonomies

get

/content/management/api/v1.1/taxonomies

This resource returns a list of available taxonomies that can be filtered by the taxonomy's status as provided in the query expression. You can control the number of items to be fetched, paginated, and sorted. Refer to the query syntax description to see the limitations.

Request

Query Parameters

• fields(optional): string
  This parameter is used to control the returned fields for a taxonomy. This parameter accepts a comma-separated list of field names or all. These fields will be returned for each taxonomy in the list. As all the field names are case-sensitive, users must provide the correct field names in the query. Each taxonomy has both standard fields (id, name, description, shortName, status, version, isPublishable, isForSiteManagement, customProperties, createdBy, createdDate, updatedBy, updatedDate) and additional fields (availableStates, publishedChannels, categoryProperties and roleName). When fields is specified as all (case-insensitive), all the standard and additional fields are returned. The standard fields are always returned in the response and cannot be filtered out. Taxonomy in "draft" state will not have a version. Users can only filter out the additional fields. Users cannot expand the categoryProperties sub-resource while reading a taxonomy but a link to the sub-resource API will be returned. This parameter is optional in the query and by default result shows only standard fields in the response. Any incorrect or invalid field name given in the query will result in error.
  
  This returns all standard fields along with the additional field availableStates for each taxonomy.
  Example: ?fields=availableStates
  
  This returns all standard fields along with the additional fields availableStates and publishedChannels for each taxonomy.
  Example: ?fields=availableStates,publishedChannels
  
  This returns all standard fields along with all additional fields (availableStates and publishedChannels) and a link to the sub-resource categoryProperties for each taxonomy.
  Example: ?fields=all
  
• limit(optional): integer(int32)
  This parameter accepts a non negative integer and is used to control the size of the result.

  Default Value: 100
• links(optional): string
  This parameter accepts a comma-separated list of link names. By default, this parameter gives all the links applicable. Possible values are: self, canonical, describedby, first, last, prev, next
• offset(optional): integer(int32)
  This parameter accepts a non negative integer and is used to control the start index of the result.

  Default Value: 0
• orderBy(optional): string
  Order by results.

  Default Value: name:asc
• q(optional): string
  This parameter accepts a query expression condition that matches the field values. Query conditions can be joined using AND operators and grouped with parentheses. The value of a query condition follows the format of {fieldName} {operator} "{fieldValue}". The only field names allowed are status, version, name, shortName, roleName and repositoryId. A query cannot include multiple status, version, name, shortName, roleName or repositoryId fieldNames. Both name and shortName cannot be specified in the same query.
  If no value is provided for status it defaults to "promoted". When listing taxonomies, status can be equal to "draft", "promoted" or "all". When listing taxonomies, roleName can be equal to "viewer", "editor" or "manager". If status is equals to "all", all taxonomies will be retrieved - if a taxonomy is currently available in both "draft" and "promoted" states, only "draft" will be returned. In case status equals to "all" is used in other endpoints, an error will be returned.
  The only value allowed in the operator is eq (Equals) for status, version, shortName, roleName and repositoryId.
  The only value allowed in the operator is co (Contains) for name.
  
  When updating a taxonomy the query parameter should always be provided with status set to "draft" as the default status is "promoted" and a promoted taxonomy cannot be modified.
  
  Example:
  https://{cecsdomain}/content/management/api/v1.1/taxonomies?q=(status eq "draft")
  Example:
  https://{cecsdomain}/content/management/api/v1.1/taxonomies?q=(status eq "promoted")
• totalResults(optional): boolean
  This parameter accepts a boolean flag. If specified as true, then the returned result must include the total result count.

  Default Value: false

Back to Top

Response

Supported Media Types

• application/json

200 Response

OK.

Body ()

Root Schema : Taxonomies

Type: object

Taxonomies

Show Source

• aggregationResults(optional): array aggregationResults
  Aggregation results.
• count(optional): integer(int32)
  Total number of records in the current response.
• hasMore(optional): boolean
  Check whether there are more pages to fetch.
• items(optional): array items
  Singular resources contained in the collection.
• limit(optional): integer(int32)
  Actual page size used by the server. This might not be the same as what the client requests.
• links(optional): array links
  Links of the resource.
• offset(optional): integer(int32)
  The actual index from which the singular resources are returned.
• pinned(optional): array pinned
  Pinned items. Shows items pinned at the top of search list
• scrollId(optional): string
  scrollId if the search resolved to a scroll search.
• totalResults(optional): integer(int32)
  Total number of rows that satisfy the client request (excluding the paging parameters.)

{
    "type":"object",
    "properties":{
        "hasMore":{
            "type":"boolean",
            "description":"Check whether there are more pages to fetch."
        },
        "offset":{
            "type":"integer",
            "format":"int32",
            "description":"The actual index from which the singular resources are returned."
        },
        "count":{
            "type":"integer",
            "format":"int32",
            "description":"Total number of records in the current response."
        },
        "limit":{
            "type":"integer",
            "format":"int32",
            "description":"Actual page size used by the server. This might not be the same as what the client requests."
        },
        "totalResults":{
            "type":"integer",
            "format":"int32",
            "description":"Total number of rows that satisfy the client request (excluding the paging parameters.)"
        },
        "scrollId":{
            "type":"string",
            "description":"scrollId if the search resolved to a scroll search."
        },
        "items":{
            "type":"array",
            "description":"Singular resources contained in the collection.",
            "items":{
                "$ref":"#/definitions/TaxonomyInCollection"
            }
        },
        "aggregationResults":{
            "type":"array",
            "description":"Aggregation results.",
            "items":{
                "$ref":"#/definitions/AggregationResult"
            }
        },
        "links":{
            "type":"array",
            "description":"Links of the resource.",
            "items":{
                "$ref":"#/definitions/Link"
            }
        },
        "pinned":{
            "type":"array",
            "description":"Pinned items. Shows items pinned at the top of search list",
            "items":{
                "type":"string"
            }
        }
    },
    "description":"Taxonomies"
}

Nested Schema : aggregationResults

Type: array

Aggregation results.

Show Source

• Array of: object AggregationResult

{
    "type":"array",
    "description":"Aggregation results.",
    "items":{
        "$ref":"#/definitions/AggregationResult"
    }
}

Nested Schema : items

Type: array

Singular resources contained in the collection.

Show Source

• Array of: object TaxonomyInCollection
  Taxonomy in Collection Response

{
    "type":"array",
    "description":"Singular resources contained in the collection.",
    "items":{
        "$ref":"#/definitions/TaxonomyInCollection"
    }
}

Nested Schema : links

Type: array

Links of the resource.

Show Source

• Array of: object Link
  Link of the resource.

{
    "type":"array",
    "description":"Links of the resource.",
    "items":{
        "$ref":"#/definitions/Link"
    }
}

Nested Schema : pinned

Type: array

Pinned items. Shows items pinned at the top of search list

Show Source

• Array of: string

{
    "type":"array",
    "description":"Pinned items. Shows items pinned at the top of search list",
    "items":{
        "type":"string"
    }
}

Nested Schema : AggregationResult

Type: object

Show Source

• name(optional): string
  Read Only: true

{
    "type":"object",
    "properties":{
        "name":{
            "type":"string",
            "readOnly":true
        }
    }
}

Nested Schema : TaxonomyInCollection

Type: object

Taxonomy in Collection Response

Show Source

• availableStates(optional): array availableStates
  List all states of the Taxonomy. This is an optional property and is only returned if requested in the fields parameter. It is ignored in post/put requests.
• categoryProperties(optional): object ItemSubResourceListCategoryPropertyDefinition
  Item SubResource.
• createdBy(optional): string
  The user who created the Taxonomy.
• createdDate(optional): object date
  date
• customProperties(optional): object customProperties
  Additional Properties Allowed: additionalProperties

  Custom properties of the Taxonomy. This consists of a name value pairs defined by the user. Single entries cannot be updated, the entire list of custom properties have to be provided to update entries.
• description(optional): string
  The description of the Taxonomy.
• id: string
  The id of the Taxonomy. This is a required property in the get response and ignored in post/put requests.
• isForSiteManagement(optional): boolean
  Whether taxonomy is for site management. A site management taxonomy is not publishable. (defaults to false)
• isPublishable(optional): boolean
  Whether taxonomy is publishable. (defaults to false)
• links(optional): array links
  Links
• name: string
  The name of the Taxonomy. It is a required property in the get response and cannot be empty in post/put request.
• roleName(optional): string
  name of the role on the resource.
• shortName(optional): string
  The short name of the Taxonomy. This property is unique among all taxonomies and it is required in the get response. Up to 3 characters can be provided in a put/post request. If no value is provided, a default one will be generated.
• status(optional): string
  Allowed Values: [ "draft", "promoted" ]

  The status of the Taxonomy. This is a required property in the get response and ignored in post/put requests.
• updatedBy(optional): string
  The user who last updated the Taxonomy.
• updatedDate(optional): object date
  date
• version(optional): integer(int32)
  Minimum Value: 1

  The version of this Taxonomy. Version information is only returned for promoted taxonomies. It is ignored in post/put requests.

{
    "type":"object",
    "required":[
        "id",
        "name"
    ],
    "properties":{
        "id":{
            "type":"string",
            "description":"The id of the Taxonomy. This is a required property in the get response and ignored in post/put requests."
        },
        "name":{
            "type":"string",
            "description":"The name of the Taxonomy. It is a required property in the get response and cannot be empty in post/put request."
        },
        "description":{
            "type":"string",
            "description":"The description of the Taxonomy."
        },
        "shortName":{
            "type":"string",
            "description":"The short name of the Taxonomy. This property is unique among all taxonomies and it is required in the get response. Up to 3 characters can be provided in a put/post request. If no value is provided, a default one will be generated."
        },
        "status":{
            "type":"string",
            "description":"The status of the Taxonomy. This is a required property in the get response and ignored in post/put requests.",
            "enum":[
                "draft",
                "promoted"
            ]
        },
        "version":{
            "type":"integer",
            "format":"int32",
            "description":"The version of this Taxonomy. Version information is only returned for promoted taxonomies. It is ignored in post/put requests.",
            "minimum":1
        },
        "isPublishable":{
            "type":"boolean",
            "description":"Whether taxonomy is publishable. (defaults to false)"
        },
        "isForSiteManagement":{
            "type":"boolean",
            "description":"Whether taxonomy is for site management. A site management taxonomy is not publishable. (defaults to false)"
        },
        "roleName":{
            "type":"string",
            "description":"name of the role on the resource."
        },
        "availableStates":{
            "type":"array",
            "description":"List all states of the Taxonomy. This is an optional property and is only returned if requested in the fields parameter. It is ignored in post/put requests.",
            "items":{
                "$ref":"#/definitions/TaxonomyStatus"
            }
        },
        "customProperties":{
            "type":"object",
            "description":"Custom properties of the Taxonomy. This consists of a name value pairs defined by the user.  Single entries cannot be updated, the entire list of custom properties have to be provided to update entries.",
            "additionalProperties":{
                "type":"string"
            }
        },
        "createdBy":{
            "type":"string",
            "description":"The user who created the Taxonomy."
        },
        "createdDate":{
            "description":"The creation date of the Taxonomy.",
            "$ref":"#/definitions/date"
        },
        "updatedBy":{
            "type":"string",
            "description":"The user who last updated the Taxonomy."
        },
        "updatedDate":{
            "description":"The date the Taxonomy was last updated.",
            "$ref":"#/definitions/date"
        },
        "categoryProperties":{
            "description":"The definition of category properties for this taxonomy. There are user defined properties and system defined properties such as synonyms, keywords and related categories. These properties are defined as a sub-resource of a single taxonomy and they cannot be expanded through read taxonomy API. They will be ignored by the server in POST and PUT requests. The sub-resource API contains additional information about parameters and available operations.",
            "$ref":"#/definitions/ItemSubResourceListCategoryPropertyDefinition"
        },
        "links":{
            "type":"array",
            "description":"Links",
            "items":{
                "$ref":"#/definitions/Link"
            }
        }
    },
    "description":"Taxonomy in Collection Response"
}

Nested Schema : availableStates

Type: array

List all states of the Taxonomy. This is an optional property and is only returned if requested in the fields parameter. It is ignored in post/put requests.

Show Source

• Array of: object TaxonomyStatus
  TaxonomyStatus

{
    "type":"array",
    "description":"List all states of the Taxonomy. This is an optional property and is only returned if requested in the fields parameter. It is ignored in post/put requests.",
    "items":{
        "$ref":"#/definitions/TaxonomyStatus"
    }
}

Nested Schema : ItemSubResourceListCategoryPropertyDefinition

Type: object

Item SubResource.

Show Source

• data(optional): array data
• links(optional): array links
• totalResults(optional): integer(int32)

{
    "type":"object",
    "properties":{
        "totalResults":{
            "type":"integer",
            "format":"int32"
        },
        "data":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/CategoryPropertyDefinition"
            }
        },
        "links":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/Link"
            }
        }
    },
    "description":"Item SubResource."
}

Nested Schema : date

Type: object

date

Show Source

• timezone(optional): string
• value(optional): string

{
    "type":"object",
    "properties":{
        "value":{
            "type":"string"
        },
        "timezone":{
            "type":"string"
        }
    },
    "description":"date"
}

Nested Schema : customProperties

Type: object

Additional Properties Allowed

Show Source

• string

{
    "type":"object",
    "description":"Custom properties of the Taxonomy. This consists of a name value pairs defined by the user.  Single entries cannot be updated, the entire list of custom properties have to be provided to update entries.",
    "additionalProperties":{
        "type":"string"
    }
}

Custom properties of the Taxonomy. This consists of a name value pairs defined by the user. Single entries cannot be updated, the entire list of custom properties have to be provided to update entries.

Nested Schema : links

Type: array

Links

Show Source

• Array of: object Link
  Link of the resource.

{
    "type":"array",
    "description":"Links",
    "items":{
        "$ref":"#/definitions/Link"
    }
}

Nested Schema : TaxonomyStatus

Type: object

TaxonomyStatus

Show Source

• jobs(optional): array jobs
• published(optional): boolean
• status(optional): string
• version(optional): integer(int32)

{
    "type":"object",
    "properties":{
        "status":{
            "type":"string"
        },
        "version":{
            "type":"integer",
            "format":"int32"
        },
        "published":{
            "type":"boolean"
        },
        "jobs":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/TaxonomyJobInfo"
            }
        }
    },
    "description":"TaxonomyStatus"
}

Nested Schema : jobs

Type: array

Show Source

• Array of: object TaxonomyJobInfo
  TaxonomyJobInfo

{
    "type":"array",
    "items":{
        "$ref":"#/definitions/TaxonomyJobInfo"
    }
}

Nested Schema : TaxonomyJobInfo

Type: object

TaxonomyJobInfo

Show Source

• errorDetails(optional): string
• id(optional): string
• status(optional): string
• type(optional): string

{
    "type":"object",
    "properties":{
        "id":{
            "type":"string"
        },
        "type":{
            "type":"string"
        },
        "status":{
            "type":"string"
        },
        "errorDetails":{
            "type":"string"
        }
    },
    "description":"TaxonomyJobInfo"
}

Nested Schema : data

Type: array

Show Source

• Array of: object CategoryPropertyDefinition
  Category Property Definition

{
    "type":"array",
    "items":{
        "$ref":"#/definitions/CategoryPropertyDefinition"
    }
}

Nested Schema : links

Type: array

Show Source

• Array of: object Link
  Link of the resource.

{
    "type":"array",
    "items":{
        "$ref":"#/definitions/Link"
    }
}

Nested Schema : CategoryPropertyDefinition

Type: object

Category Property Definition

Show Source

• apiName(optional): string
  Read Only: true

  Minimum Length: 1

  Maximum Length: 64

  API Name of the property.
• createdBy(optional): string
  Read Only: true

  The user who created the property.
• createdDate(optional): object date
  date
• defaultValues(optional): array defaultValues
  Default values for the property.
• description(optional): string
  Minimum Length: 0

  Maximum Length: 128

  Description of the property.
• displayName: string
  Minimum Length: 1

  Maximum Length: 128

  Display name of the property.
• id(optional): string
  Read Only: true

  id of the property. It is required in the GET response and PATCH request whereas it will be ignored in the POST request.
• isPublishable(optional): boolean
  Is the property publishable.
• isSystemManaged(optional): boolean
  Read Only: true

  Is the property managed by the system.
• links(optional): array links
  Links
• settings: object PropertySettingsBean
• updatedBy(optional): string
  Read Only: true

  The user who last updated the property.
• updatedDate(optional): object date
  date
• valueCount: string
  Allowed Values: [ "single", "list" ]

  Value count as a single or list.

{
    "type":"object",
    "required":[
        "displayName",
        "settings",
        "valueCount"
    ],
    "properties":{
        "id":{
            "type":"string",
            "description":"id of the property. It is required in the GET response and PATCH request whereas it will be ignored in the POST request.",
            "readOnly":true
        },
        "apiName":{
            "type":"string",
            "description":"API Name of the property.",
            "readOnly":true,
            "minLength":1,
            "maxLength":64
        },
        "displayName":{
            "type":"string",
            "description":"Display name of the property.",
            "minLength":1,
            "maxLength":128
        },
        "description":{
            "type":"string",
            "description":"Description of the property.",
            "minLength":0,
            "maxLength":128
        },
        "isSystemManaged":{
            "type":"boolean",
            "description":"Is the property managed by the system.",
            "readOnly":true
        },
        "isPublishable":{
            "type":"boolean",
            "description":"Is the property publishable."
        },
        "valueCount":{
            "type":"string",
            "description":"Value count as a single or list.",
            "enum":[
                "single",
                "list"
            ]
        },
        "defaultValues":{
            "type":"array",
            "description":"Default values for the property.",
            "items":{
                "type":"string"
            }
        },
        "settings":{
            "description":"Settings for the property.",
            "$ref":"#/definitions/PropertySettingsBean"
        },
        "createdBy":{
            "type":"string",
            "description":"The user who created the property.",
            "readOnly":true
        },
        "createdDate":{
            "description":"The creation date of the property.",
            "readOnly":true,
            "$ref":"#/definitions/date"
        },
        "updatedBy":{
            "type":"string",
            "description":"The user who last updated the property.",
            "readOnly":true
        },
        "updatedDate":{
            "description":"The last updated date of the property.",
            "readOnly":true,
            "$ref":"#/definitions/date"
        },
        "links":{
            "type":"array",
            "description":"Links",
            "items":{
                "$ref":"#/definitions/Link"
            }
        }
    },
    "description":"Category Property Definition"
}

Nested Schema : defaultValues

Type: array

Default values for the property.

Show Source

• Array of: string

{
    "type":"array",
    "description":"Default values for the property.",
    "items":{
        "type":"string"
    }
}

Nested Schema : links

Type: array

Links

Show Source

• Array of: object Link
  Link of the resource.

{
    "type":"array",
    "description":"Links",
    "items":{
        "$ref":"#/definitions/Link"
    }
}

Nested Schema : PropertySettingsBean

Type: object

Show Source

• caas(optional): object PropertySettingsCaasBean

{
    "type":"object",
    "properties":{
        "caas":{
            "description":"settings of the property. It is required in the GET response and PUT request whereas it is not required in the POST request.",
            "$ref":"#/definitions/PropertySettingsCaasBean"
        }
    }
}

Nested Schema : Link

Type: object

Link of the resource.

Show Source

• href(optional): string
  The target resource's URI. It could be template URI. It is a required property in the get response.
• mediaType(optional): string
  Media type.
• method(optional): string
  What HTTP method can be used to access the target resource.
• profile(optional): string
  Link to the metadata that describes the target resource.
• rel(optional): string
  Relation type. It is a required property in the get response.
• templated(optional): boolean
  Whether the URI is a template.

{
    "type":"object",
    "properties":{
        "href":{
            "type":"string",
            "description":"The target resource's URI. It could be template URI. It is a required property in the get response."
        },
        "rel":{
            "type":"string",
            "description":"Relation type. It is a required property in the get response."
        },
        "templated":{
            "type":"boolean",
            "description":"Whether the URI is a template."
        },
        "method":{
            "type":"string",
            "description":"What HTTP method can be used to access the target resource."
        },
        "profile":{
            "type":"string",
            "description":"Link to the metadata that describes the target resource."
        },
        "mediaType":{
            "type":"string",
            "description":"Media type."
        }
    },
    "description":"Link of the resource."
}

Nested Schema : PropertySettingsCaasBean

Type: object

Show Source

• customValidators(optional): array customValidators
  Custom validators for the property value.
• editor(optional): object PropertySettingsEditorBean
• valueCountRange(optional): object PropertySettingsValueCountRangeBean

{
    "type":"object",
    "properties":{
        "valueCountRange":{
            "description":"Value count range of the property.",
            "$ref":"#/definitions/PropertySettingsValueCountRangeBean"
        },
        "customValidators":{
            "type":"array",
            "description":"Custom validators for the property value.",
            "items":{
                "$ref":"#/definitions/PropertySettingsValidatorBean"
            }
        },
        "editor":{
            "description":"Editor for the property value.",
            "$ref":"#/definitions/PropertySettingsEditorBean"
        }
    }
}

Nested Schema : customValidators

Type: array

Custom validators for the property value.

Show Source

• Array of: object PropertySettingsValidatorBean

{
    "type":"array",
    "description":"Custom validators for the property value.",
    "items":{
        "$ref":"#/definitions/PropertySettingsValidatorBean"
    }
}

Nested Schema : PropertySettingsEditorBean

Type: object

Show Source

• name(optional): string
  Name of the editor.
• options(optional): object options
  Additional Properties Allowed: additionalProperties

  Options of the property value.

{
    "type":"object",
    "properties":{
        "name":{
            "type":"string",
            "description":"Name of the editor."
        },
        "options":{
            "type":"object",
            "description":"Options of the property value.",
            "additionalProperties":{
                "type":"object"
            }
        }
    }
}

Nested Schema : PropertySettingsValueCountRangeBean

Type: object

Show Source

• max(optional): integer(int32)
  Minimum Value: 1

  Maximum count of the property value.
• min(optional): integer(int32)
  Minimum Value: 0

  Minimum count of the property value.

{
    "type":"object",
    "properties":{
        "min":{
            "type":"integer",
            "format":"int32",
            "description":"Minimum count of the property value.",
            "minimum":0
        },
        "max":{
            "type":"integer",
            "format":"int32",
            "description":"Maximum count of the property value.",
            "minimum":1
        }
    }
}

Nested Schema : PropertySettingsValidatorBean

Type: object

Show Source

• options(optional): object options
  Additional Properties Allowed: additionalProperties

  Validator details.
• type(optional): string
  Allowed Values: [ "length" ]

  Type of the validator.

{
    "type":"object",
    "properties":{
        "type":{
            "type":"string",
            "description":"Type of the validator.",
            "enum":[
                "length"
            ]
        },
        "options":{
            "type":"object",
            "description":"Validator details.",
            "additionalProperties":{
                "type":"object"
            }
        }
    }
}

Nested Schema : options

Type: object

Additional Properties Allowed

Show Source

• object additionalProperties

{
    "type":"object",
    "description":"Validator details.",
    "additionalProperties":{
        "type":"object"
    }
}

Validator details.

Nested Schema : additionalProperties

Type: object

Nested Schema : options

Type: object

Additional Properties Allowed

Show Source

• object additionalProperties

{
    "type":"object",
    "description":"Options of the property value.",
    "additionalProperties":{
        "type":"object"
    }
}

Options of the property value.

Nested Schema : additionalProperties

Type: object

400 Response

Bad request.

403 Response

Forbidden.

500 Response

Internal server error.

Back to Top

Examples

The following examples show how to fetch the promoted and draft taxonomies by submitting a GET request using cURL.

curl -X GET -H 'Accept: application/json' 'https://host:port/content/management/api/v1.1/taxonomies'

Example 1:

This returns a list of promoted (default) taxonomies.

/content/management/api/v1.1/taxonomies

Response Body

{
  "hasMore": false,
  "offset": 0,
  "count": 4,
  "limit": 100,
  "items": [
    {
      "id": "5D5AF080B7824C49950443A7D51DE950",
      "name": "Taxonomy 1",
      "description": "",
      "shortName": "T1",
      "status": "promoted",
      "version": 4,
      "isPublishable": false,
      "isForSiteManagement": false,
      "createdBy": "cecusername",
      "createdDate": {
        "value": "2019-01-31T19:52:45.472Z",
        "timezone": "UTC"
      },
      "updatedBy": "cecusername",
      "updatedDate": {
        "value": "2019-02-01T17:49:43.854Z",
        "timezone": "UTC"
      },
      "links": [
        {
          "href": "https://<hostname>/content/management/api/v1.1/taxonomies/5D5AF080B7824C49950443A7D51DE950",
          "rel": "self",
          "method": "GET",
          "mediaType": "application/json"
        }
      ]
    },
    {
      "id": "22ED0446197F49B490619206DEC71482",
      "name": "Taxonomy 2",
      "description": "Some description",
      "shortName": "T2",
      "status": "promoted",
      "version": 5,
      "isPublishable": false,
      "isForSiteManagement": false,
      "createdBy": "cecusername",
      "createdDate": {
        "value": "2019-02-01T17:48:25.082Z",
        "timezone": "UTC"
      },
      "updatedBy": "cecusername",
      "updatedDate": {
        "value": "2019-02-01T17:49:52.936Z",
        "timezone": "UTC"
      },
      "links": [
        {
          "href": "https://<hostname>/content/management/api/v1.1/taxonomies/22ED0446197F49B490619206DEC71482",
          "rel": "self",
          "method": "GET",
          "mediaType": "application/json"
        }
      ]
    },
    {
      "id": "D7969D6CA0D144AEA9CCA88BA6D2CF81",
      "name": "Taxonomy 3",
      "description": "Another description",
      "shortName": "T3",
      "status": "promoted",
      "version": 6,
      "isPublishable": false,
      "isForSiteManagement": false,
      "createdBy": "cecusername",
      "createdDate": {
        "value": "2019-02-01T17:49:08.832Z",
        "timezone": "UTC"
      },
      "updatedBy": "cecusername",
      "updatedDate": {
        "value": "2019-02-01T17:50:00.951Z",
        "timezone": "UTC"
      },
      "links": [
        {
          "href": "https://<hostname>/content/management/api/v1.1/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81",
          "rel": "self",
          "method": "GET",
          "mediaType": "application/json"
        }
      ]
    },
    {
      "id": "FB8240D6DC70407F87ED111325D06F89",
      "name": "Organization1",
      "description": "organization one taxonomy",
      "shortName": "ORG",
      "status": "promoted",
      "version": 1,
      "isPublishable": false,
      "isForSiteManagement": true,
      "createdBy": "cecusername",
      "createdDate": {
        "value": "2022-12-14T07:15:17.269Z",
        "timezone": "UTC"
      },
      "updatedBy": "cecusername",
      "updatedDate": {
        "value": "2022-12-14T07:22:38.724Z",
        "timezone": "UTC"
      },
      "links": [
        {
          "href": "https://<hostname>/content/management/api/v1.1/taxonomies/FB8240D6DC70407F87ED111325D06F89",
          "rel": "self",
          "method": "GET",
          "mediaType": "application/json"
        }
      ]
    }
  ],
  "links": [
    {
      "href": "https://<hostname>/content/management/api/v1.1/taxonomies",
      "rel": "self",
      "method": "GET",
      "mediaType": "application/json"
    },
    {
      "href": "https://<hostname>/content/management/api/v1.1/taxonomies",
      "rel": "canonical",
      "method": "GET",
      "mediaType": "application/json"
    },
    {
      "href": "https://<hostname>/content/management/api/v1.1/metadata-catalog/taxonomies",
      "rel": "describedby",
      "method": "GET",
      "mediaType": "application/schema+json"
    },
    {
      "href": "https://<hostname>/content/management/api/v1.1/taxonomies?offset=0",
      "rel": "first",
      "method": "GET",
      "mediaType": "application/json"
    },
    {
      "href": "https://<hostname>/content/management/api/v1.1/taxonomies?offset=0",
      "rel": "last",
      "method": "GET",
      "mediaType": "application/json"
    }
  ]
}

Example 2:

This returns a list of draft taxonomies.

/content/management/api/v1.1/taxonomies?q=(status eq \"draft\")

Response Body

{
  "hasMore": false,
  "offset": 0,
  "count": 3,
  "limit": 100,
  "items": [
    {
      "id": "5D5AF080B7824C49950443A7D51DE950",
      "name": "Taxonomy 1",
      "description": "",
      "shortName": "T1",
      "status": "draft",
      "isPublishable": false,
      "isForSiteManagement": false,
      "createdBy": "cecusername",
      "createdDate": {
        "value": "2019-02-01T17:50:09.286Z",
        "timezone": "UTC"
      },
      "updatedBy": "cecusername",
      "updatedDate": {
        "value": "2019-02-01T17:50:09.286Z",
        "timezone": "UTC"
      },
      "links": [
        {
          "href": "https://<hoastname>/content/management/api/v1.1/taxonomies/5D5AF080B7824C49950443A7D51DE950?q=(status eq \"draft\")",
          "rel": "self",
          "method": "GET",
          "mediaType": "application/json"
        }
      ]
    },
    {
      "id": "22ED0446197F49B490619206DEC71482",
      "name": "Taxonomy 2",
      "description": "Some description",
      "shortName": "T2",
      "status": "draft",
      "isPublishable": false,
      "isForSiteManagement": false,
      "createdBy": "cecusername",
      "createdDate": {
        "value": "2019-02-01T17:50:17.648Z",
        "timezone": "UTC"
      },
      "updatedBy": "cecusername",
      "updatedDate": {
        "value": "2019-02-01T17:50:17.648Z",
        "timezone": "UTC"
      },
      "links": [
        {
          "href": "https://<hoastname>/content/management/api/v1.1/taxonomies/22ED0446197F49B490619206DEC71482?q=(status eq \"draft\")",
          "rel": "self",
          "method": "GET",
          "mediaType": "application/json"
        }
      ]
    },
    {
      "id": "D7969D6CA0D144AEA9CCA88BA6D2CF81",
      "name": "Taxonomy 3",
      "description": "Another description",
      "shortName": "T3",
      "status": "draft",
      "isPublishable": false,
      "isForSiteManagement": false,
      "createdBy": "cecusername",
      "createdDate": {
        "value": "2019-02-01T17:50:26.936Z",
        "timezone": "UTC"
      },
      "updatedBy": "cecusername",
      "updatedDate": {
        "value": "2019-02-01T17:50:26.936Z",
        "timezone": "UTC"
      },
      "links": [
        {
          "href": "https://<hoastname>/content/management/api/v1.1/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81?q=(status eq \"draft\")",
          "rel": "self",
          "method": "GET",
          "mediaType": "application/json"
        }
      ]
    }
  ],
  "links": [
    {
      "href": "https://<hoastname>/content/management/api/v1.1/taxonomies?q=(status eq \"draft\")",
      "rel": "self",
      "method": "GET",
      "mediaType": "application/json"
    },
    {
      "href": "https://<hoastname>/content/management/api/v1.1/taxonomies?q=(status eq \"draft\")",
      "rel": "canonical",
      "method": "GET",
      "mediaType": "application/json"
    },
    {
      "href": "https://<hoastname>/content/management/api/v1.1/metadata-catalog/taxonomies",
      "rel": "describedby",
      "method": "GET",
      "mediaType": "application/schema+json"
    },
    {
      "href": "https://<hoastname>/content/management/api/v1.1/taxonomies?offset=0&q=(status eq \"draft\")",
      "rel": "first",
      "method": "GET",
      "mediaType": "application/json"
    },
    {
      "href": "https://<hoastname>/content/management/api/v1.1/taxonomies?offset=0&q=(status eq \"draft\")",
      "rel": "last",
      "method": "GET",
      "mediaType": "application/json"
    }
  ]
}

Example 3:

This returns a list of promoted taxonomies from offset=1.

/content/management/api/v1.1/taxonomies?offset=1

Response Body

{
  "hasMore": false,
  "offset": 1,
  "count": 2,
  "limit": 100,
  "items": [
    {
      "id": "22ED0446197F49B490619206DEC71482",
      "name": "Taxonomy 2",
      "description": "Some description",
      "shortName": "T2",
      "status": "promoted",
      "version": 5,
      "isPublishable": false,
      "isForSiteManagement": false,
      "createdBy": "cecusername",
      "createdDate": {
        "value": "2019-02-01T17:48:25.082Z",
        "timezone": "UTC"
      },
      "updatedBy": "cecusername",
      "updatedDate": {
        "value": "2019-02-01T17:49:52.936Z",
        "timezone": "UTC"
      },
      "links": [
        {
          "href": "https://<hoastname>/content/management/api/v1.1/taxonomies/22ED0446197F49B490619206DEC71482?offset=1",
          "rel": "self",
          "method": "GET",
          "mediaType": "application/json"
        }
      ]
    },
    {
      "id": "D7969D6CA0D144AEA9CCA88BA6D2CF81",
      "name": "Taxonomy 3",
      "description": "Another description",
      "shortName": "T3",
      "status": "promoted",
      "version": 6,
      "isPublishable": false,
      "isForSiteManagement": false,
      "createdBy": "cecusername",
      "createdDate": {
        "value": "2019-02-01T17:49:08.832Z",
        "timezone": "UTC"
      },
      "updatedBy": "cecusername",
      "updatedDate": {
        "value": "2019-02-01T17:50:00.951Z",
        "timezone": "UTC"
      },
      "links": [
        {
          "href": "https://<hoastname>/content/management/api/v1.1/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81?offset=1",
          "rel": "self",
          "method": "GET",
          "mediaType": "application/json"
        }
      ]
    }
  ],
  "links": [
    {
      "href": "https://<hoastname>/content/management/api/v1.1/taxonomies?offset=1",
      "rel": "self",
      "method": "GET",
      "mediaType": "application/json"
    },
    {
      "href": "https://<hoastname>/content/management/api/v1.1/taxonomies?offset=1",
      "rel": "canonical",
      "method": "GET",
      "mediaType": "application/json"
    },
    {
      "href": "https://<hoastname>/content/management/api/v1.1/metadata-catalog/taxonomies",
      "rel": "describedby",
      "method": "GET",
      "mediaType": "application/schema+json"
    },
    {
      "href": "https://<hoastname>/content/management/api/v1.1/taxonomies?offset=0",
      "rel": "prev",
      "method": "GET",
      "mediaType": "application/json"
    },
    {
      "href": "https://<hoastname>/content/management/api/v1.1/taxonomies?offset=0",
      "rel": "first",
      "method": "GET",
      "mediaType": "application/json"
    },
    {
      "href": "https://<hoastname>/content/management/api/v1.1/taxonomies?offset=1",
      "rel": "last",
      "method": "GET",
      "mediaType": "application/json"
    }
  ]
}

Example 4:

This returns a list of promoted taxonomies from offset=1 and 1 item per page.

/content/management/api/v1.1/taxonomies?offset=1&limit=1

Response Body

{
  "hasMore": true,
  "offset": 1,
  "count": 1,
  "limit": 1,
  "items": [
    {
      "id": "22ED0446197F49B490619206DEC71482",
      "name": "Taxonomy 2",
      "description": "Some description",
      "shortName": "T2",
      "status": "promoted",
      "version": 5,
      "isPublishable": false,
      "isForSiteManagement": false,
      "createdBy": "cecusername",
      "createdDate": {
        "value": "2019-02-01T17:48:25.082Z",
        "timezone": "UTC"
      },
      "updatedBy": "cecusername",
      "updatedDate": {
        "value": "2019-02-01T17:49:52.936Z",
        "timezone": "UTC"
      },
      "links": [
        {
          "href": "https://<hoastname>/content/management/api/v1.1/taxonomies/22ED0446197F49B490619206DEC71482?offset=1&limit=1",
          "rel": "self",
          "method": "GET",
          "mediaType": "application/json"
        }
      ]
    }
  ],
  "links": [
    {
      "href": "https://<hoastname>/content/management/api/v1.1/taxonomies?offset=1&limit=1",
      "rel": "self",
      "method": "GET",
      "mediaType": "application/json"
    },
    {
      "href": "https://<hoastname>/content/management/api/v1.1/taxonomies?offset=1&limit=1",
      "rel": "canonical",
      "method": "GET",
      "mediaType": "application/json"
    },
    {
      "href": "https://<hoastname>/content/management/api/v1.1/metadata-catalog/taxonomies",
      "rel": "describedby",
      "method": "GET",
      "mediaType": "application/schema+json"
    },
    {
      "href": "https://<hoastname>/content/management/api/v1.1/taxonomies?offset=0&limit=1",
      "rel": "prev",
      "method": "GET",
      "mediaType": "application/json"
    },
    {
      "href": "https://<hoastname>/content/management/api/v1.1/taxonomies?offset=2&limit=1",
      "rel": "next",
      "method": "GET",
      "mediaType": "application/json"
    },
    {
      "href": "https://<hoastname>/content/management/api/v1.1/taxonomies?offset=0&limit=1",
      "rel": "first",
      "method": "GET",
      "mediaType": "application/json"
    },
    {
      "href": "https://<hoastname>/content/management/api/v1.1/taxonomies?offset=2&limit=1",
      "rel": "last",
      "method": "GET",
      "mediaType": "application/json"
    }
  ]
}

Example 5:

This lists all the promoted taxonomies as well as the optional field 'availableStates'.

/content/management/api/v1.1/taxonomies?fields=availableStates

Response Body

{
  "hasMore": false,
  "offset": 0,
  "count": 3,
  "limit": 100,
  "items": [
    {
      "id": "5D5AF080B7824C49950443A7D51DE950",
      "name": "Taxonomy 1",
      "description": "",
      "shortName": "T1",
      "status": "promoted",
      "version": 4,
      "isPublishable": false,
      "isForSiteManagement": false,
      "availableStates": [
        {
          "status": "promoted",
          "version": 4,
          "published": false
        },
        {
          "status": "draft",
          "published": false
        }
      ],
      "createdBy": "cecusername",
      "createdDate": {
        "value": "2019-01-31T19:52:45.472Z",
        "timezone": "UTC"
      },
      "updatedBy": "cecusername",
      "updatedDate": {
        "value": "2019-02-01T17:49:43.854Z",
        "timezone": "UTC"
      },
      "links": [
        {
          "href": "https://<hostname>/content/management/api/v1.1/taxonomies/5D5AF080B7824C49950443A7D51DE950?fields=availableStates",
          "rel": "self",
          "method": "GET",
          "mediaType": "application/json"
        }
      ]
    },
    {
      "id": "22ED0446197F49B490619206DEC71482",
      "name": "Taxonomy 2",
      "description": "Some description",
      "shortName": "T2",
      "status": "promoted",
      "version": 5,
      "isPublishable": false,
      "isForSiteManagement": false,
      "availableStates": [
        {
          "status": "promoted",
          "version": 5,
          "published": false
        },
        {
          "status": "draft",
          "published": false
        }
      ],
      "createdBy": "cecusername",
      "createdDate": {
        "value": "2019-02-01T17:48:25.082Z",
        "timezone": "UTC"
      },
      "updatedBy": "cecusername",
      "updatedDate": {
        "value": "2019-02-01T17:49:52.936Z",
        "timezone": "UTC"
      },
      "links": [
        {
          "href": "https://<hostname>/content/management/api/v1.1/taxonomies/22ED0446197F49B490619206DEC71482?fields=availableStates",
          "rel": "self",
          "method": "GET",
          "mediaType": "application/json"
        }
      ]
    },
    {
      "id": "D7969D6CA0D144AEA9CCA88BA6D2CF81",
      "name": "Taxonomy 3",
      "description": "Another description",
      "shortName": "T3",
      "status": "promoted",
      "version": 6,
      "isPublishable": false,
      "isForSiteManagement": false,
      "availableStates": [
        {
          "status": "promoted",
          "version": 6,
          "published": false
        },
        {
          "status": "draft",
          "published": false
        }
      ],
      "createdBy": "cecusername",
      "createdDate": {
        "value": "2019-02-01T17:49:08.832Z",
        "timezone": "UTC"
      },
      "updatedBy": "cecusername",
      "updatedDate": {
        "value": "2019-02-01T17:50:00.951Z",
        "timezone": "UTC"
      },
      "links": [
        {
          "href": "https://<hostname>/content/management/api/v1.1/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81?fields=availableStates",
          "rel": "self",
          "method": "GET",
          "mediaType": "application/json"
        }
      ]
    }
  ],
  "links": [
    {
      "href": "https://<hostname>/content/management/api/v1.1/taxonomies?fields=availableStates",
      "rel": "self",
      "method": "GET",
      "mediaType": "application/json"
    },
    {
      "href": "https://<hostname>/content/management/api/v1.1/taxonomies?fields=availableStates",
      "rel": "canonical",
      "method": "GET",
      "mediaType": "application/json"
    },
    {
      "href": "https://<hostname>/content/management/api/v1.1/metadata-catalog/taxonomies",
      "rel": "describedby",
      "method": "GET",
      "mediaType": "application/schema+json"
    },
    {
      "href": "https://<hostname>/content/management/api/v1.1/taxonomies?fields=availableStates&offset=0",
      "rel": "first",
      "method": "GET",
      "mediaType": "application/json"
    },
    {
      "href": "https://<hostname>/content/management/api/v1.1/taxonomies?fields=availableStates&offset=0",
      "rel": "last",
      "method": "GET",
      "mediaType": "application/json"
    }
  ]
}

Example 6:

Returns a list of promoted taxonomies.

/content/management/api/v1.1/taxonomies?q=(status eq \"promoted\")

Response Body

{
  "hasMore": true,
  "offset": 0,
  "count": 1,
  "limit": 1,
  "items": [
    {
      "id": "5D5AF080B7824C49950443A7D51DE950",
      "name": "Taxonomy 1",
      "description": "",
      "shortName": "T1",
      "status": "promoted",
      "version": 4,
      "isPublishable": false,
      "isForSiteManagement": false,
      "createdBy": "cecusername",
      "createdDate": {
        "value": "2019-01-31T19:52:45.472Z",
        "timezone": "UTC"
      },
      "updatedBy": "cecusername",
      "updatedDate": {
        "value": "2019-02-01T17:49:43.854Z",
        "timezone": "UTC"
      },
      "links": [
        {
          "href": "https://<hostname>/content/management/api/v1.1/taxonomies/5D5AF080B7824C49950443A7D51DE950?limit=1&q=(status eq \"promoted\")",
          "rel": "self",
          "method": "GET",
          "mediaType": "application/json"
        }
      ]
    }
  ],
  "links": [
    {
      "href": "https://<hostname>/content/management/api/v1.1/taxonomies?limit=1&q=(status eq \"promoted\")",
      "rel": "self",
      "method": "GET",
      "mediaType": "application/json"
    },
    {
      "href": "https://<hostname>/content/management/api/v1.1/taxonomies?limit=1&q=(status eq \"promoted\")",
      "rel": "canonical",
      "method": "GET",
      "mediaType": "application/json"
    },
    {
      "href": "https://<hostname>/content/management/api/v1.1/metadata-catalog/taxonomies",
      "rel": "describedby",
      "method": "GET",
      "mediaType": "application/schema+json"
    },
    {
      "href": "https://<hostname>/content/management/api/v1.1/taxonomies?limit=1&offset=1&q=(status eq \"promoted\")",
      "rel": "next",
      "method": "GET",
      "mediaType": "application/json"
    },
    {
      "href": "https://<hostname>/content/management/api/v1.1/taxonomies?limit=1&offset=0&q=(status eq \"promoted\")",
      "rel": "first",
      "method": "GET",
      "mediaType": "application/json"
    },
    {
      "href": "https://<hostname>/content/management/api/v1.1/taxonomies?limit=1&offset=2&q=(status eq \"promoted\")",
      "rel": "last",
      "method": "GET",
      "mediaType": "application/json"
    }
  ]
}

Example 7:

Returns a list of promoted taxonomies with a taxonomy name that contains product.

/content/management/api/v1.1/taxonomies?q=(status eq \"promoted\" AND name co \"product\")

Response Body

{
  "hasMore": true,
  "offset": 0,
  "count": 1,
  "limit": 1,
  "items": [
    {
      "id": "5D5AF080B7824C49950443A7D51DE9F1",
      "name": "Product Colors",
      "description": "",
      "shortName": "COL",
      "status": "promoted",
      "version": 2,
      "isPublishable": false,
      "isForSiteManagement": false,
      "createdBy": "cecusername",
      "createdDate": {
        "value": "2019-01-31T19:52:45.472Z",
        "timezone": "UTC"
      },
      "updatedBy": "cecusername",
      "updatedDate": {
        "value": "2019-02-01T17:49:43.854Z",
        "timezone": "UTC"
      },
      "links": [
        {
          "href": "https://<hostname>/content/management/api/v1.1/taxonomies/5D5AF080B7824C49950443A7D51DE950?limit=1&q=(status eq \"promoted\" AND name co \"product\")",
          "rel": "self",
          "method": "GET",
          "mediaType": "application/json"
        }
      ]
    }
  ],
  "links": [
    {
      "href": "https://<hostname>/content/management/api/v1.1/taxonomies?limit=1&q=(status eq \"promoted\" AND name co \"product\")",
      "rel": "self",
      "method": "GET",
      "mediaType": "application/json"
    },
    {
      "href": "https://<hostname>/content/management/api/v1.1/taxonomies?limit=1&q=(status eq \"promoted\" AND name co \"product\")",
      "rel": "canonical",
      "method": "GET",
      "mediaType": "application/json"
    },
    {
      "href": "https://<hostname>/content/management/api/v1.1/metadata-catalog/taxonomies",
      "rel": "describedby",
      "method": "GET",
      "mediaType": "application/schema+json"
    },
    {
      "href": "https://<hostname>/content/management/api/v1.1/taxonomies?limit=1&offset=0&q=(status eq \"promoted\" AND name co \"product\")",
      "rel": "first",
      "method": "GET",
      "mediaType": "application/json"
    },
    {
      "href": "https://<hostname>/content/management/api/v1.1/taxonomies?limit=1&offset=0&q=(status eq \"promoted\" AND name co \"product\")",
      "rel": "last",
      "method": "GET",
      "mediaType": "application/json"
    }
  ]
}

Example 8:

Search for a promoted taxonomy with a taxonomy short name that is col.

/content/management/api/v1.1/taxonomies?q=(status eq \"promoted\" AND shortName eq \"col\")

Response Body

{
  "hasMore": true,
  "offset": 0,
  "count": 1,
  "limit": 1,
  "items": [
    {
      "id": "5D5AF080B7824C49950443A7D51DE9F1",
      "name": "Product Colors",
      "description": "",
      "shortName": "COL",
      "status": "promoted",
      "version": 2,
      "isPublishable": false,
      "isForSiteManagement": false,
      "createdBy": "cecusername",
      "createdDate": {
        "value": "2019-01-31T19:52:45.472Z",
        "timezone": "UTC"
      },
      "updatedBy": "cecusername",
      "updatedDate": {
        "value": "2019-02-01T17:49:43.854Z",
        "timezone": "UTC"
      },
      "links": [
        {
          "href": "https://<hostname>/content/management/api/v1.1/taxonomies/5D5AF080B7824C49950443A7D51DE950?limit=1&q=(status eq \"promoted\" AND shortName eq \"col\")",
          "rel": "self",
          "method": "GET",
          "mediaType": "application/json"
        }
      ]
    }
  ],
  "links": [
    {
      "href": "https://<hostname>/content/management/api/v1.1/taxonomies?limit=1&q=(status eq \"promoted\" AND shortName eq \"col\"",
      "rel": "self",
      "method": "GET",
      "mediaType": "application/json"
    },
    {
      "href": "https://<hostname>/content/management/api/v1.1/taxonomies?limit=1&q=(status eq \"promoted\" AND shortName eq \"col\")",
      "rel": "canonical",
      "method": "GET",
      "mediaType": "application/json"
    },
    {
      "href": "https://<hostname>/content/management/api/v1.1/metadata-catalog/taxonomies",
      "rel": "describedby",
      "method": "GET",
      "mediaType": "application/schema+json"
    },
    {
      "href": "https://<hostname>/content/management/api/v1.1/taxonomies?limit=1&offset=0&q=(status eq \"promoted\" AND shortName eq \"col\")",
      "rel": "first",
      "method": "GET",
      "mediaType": "application/json"
    },
    {
      "href": "https://<hostname>/content/management/api/v1.1/taxonomies?limit=1&offset=0&q=(status eq \"promoted\" AND shortName eq \"col\")",
      "rel": "last",
      "method": "GET",
      "mediaType": "application/json"
    }
  ]
}

Example 9:

List all promoted taxonomies and the optional fields 'availableStates' and 'publishedChannels'.

/content/management/api/v1.1/taxonomies?fields=availableStates,publishedChannels

Response Body

{
  "hasMore": false,
  "offset": 0,
  "count": 3,
  "limit": 100,
  "items": [
    {
      "id": "5D5AF080B7824C49950443A7D51DE950",
      "name": "Taxonomy 1",
      "description": "",
      "shortName": "T1",
      "status": "promoted",
      "version": 4,
      "isPublishable": true,
      "isForSiteManagement": false,
      "availableStates": [
        {
          "status": "promoted",
          "version": 4,
          "published": true
        },
        {
          "status": "draft",
          "published": false
        }
      ],
      "publishedChannels": [
        {
          "id": "CC59073EACA4A56A990700ADEB643CAB64E62AA2CC55",
          "name": "Channel 02"
        },
        {
          "id": "CCD608830CFD886E62FC58DC2B89320BEA5A4052D0FC",
          "name": "Channel 01"
        }
      ],
      "createdBy": "cecusername",
      "createdDate": {
        "value": "2019-01-31T19:52:45.472Z",
        "timezone": "UTC"
      },
      "updatedBy": "cecusername",
      "updatedDate": {
        "value": "2019-02-01T17:49:43.854Z",
        "timezone": "UTC"
      },
      "links": [
        {
          "href": "https://<hostname>/content/management/api/v1.1/taxonomies/5D5AF080B7824C49950443A7D51DE950?fields=availableStates,publishedChannels",
          "rel": "self",
          "method": "GET",
          "mediaType": "application/json"
        }
      ]
    },
    {
      "id": "22ED0446197F49B490619206DEC71482",
      "name": "Taxonomy 2",
      "description": "Some description",
      "shortName": "T2",
      "status": "promoted",
      "version": 5,
      "isPublishable": false,
      "isForSiteManagement": false,
      "availableStates": [
        {
          "status": "promoted",
          "version": 5,
          "published": false
        },
        {
          "status": "draft",
          "published": false
        }
      ],
      "createdBy": "cecusername",
      "createdDate": {
        "value": "2019-02-01T17:48:25.082Z",
        "timezone": "UTC"
      },
      "updatedBy": "cecusername",
      "updatedDate": {
        "value": "2019-02-01T17:49:52.936Z",
        "timezone": "UTC"
      },
      "links": [
        {
          "href": "https://<hostname>/content/management/api/v1.1/taxonomies/22ED0446197F49B490619206DEC71482?fields=availableStates,publishedChannels",
          "rel": "self",
          "method": "GET",
          "mediaType": "application/json"
        }
      ]
    },
    {
      "id": "D7969D6CA0D144AEA9CCA88BA6D2CF81",
      "name": "Taxonomy 3",
      "description": "Another description",
      "shortName": "T3",
      "status": "promoted",
      "version": 6,
      "isPublishable": true,
      "isForSiteManagement": false,
      "availableStates": [
        {
          "status": "promoted",
          "version": 6,
          "published": true
        },
        {
          "status": "draft",
          "published": false
        }
      ],
      "publishedChannels": [
        {
          "id": "CC59073EACA4A56A990700ADEB643CAB64E62AA2CC55",
          "name": "Channel 02"
        }
      ],
      "createdBy": "cecusername",
      "createdDate": {
        "value": "2019-02-01T17:49:08.832Z",
        "timezone": "UTC"
      },
      "updatedBy": "cecusername",
      "updatedDate": {
        "value": "2019-02-01T17:50:00.951Z",
        "timezone": "UTC"
      },
      "links": [
        {
          "href": "https://<hostname>/content/management/api/v1.1/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81?fields=availableStates,publishedChannels",
          "rel": "self",
          "method": "GET",
          "mediaType": "application/json"
        }
      ]
    }
  ],
  "links": [
    {
      "href": "https://<hostname>/content/management/api/v1.1/taxonomies?fields=availableStates,publishedChannels",
      "rel": "self",
      "method": "GET",
      "mediaType": "application/json"
    },
    {
      "href": "https://<hostname>/content/management/api/v1.1/taxonomies?fields=availableStates,publishedChannels",
      "rel": "canonical",
      "method": "GET",
      "mediaType": "application/json"
    },
    {
      "href": "https://<hostname>/content/management/api/v1.1/metadata-catalog/taxonomies",
      "rel": "describedby",
      "method": "GET",
      "mediaType": "application/schema+json"
    },
    {
      "href": "https://<hostname>/content/management/api/v1.1/taxonomies?fields=availableStates,publishedChannels&offset=0",
      "rel": "first",
      "method": "GET",
      "mediaType": "application/json"
    },
    {
      "href": "https://<hostname>/content/management/api/v1.1/taxonomies?fields=availableStates,publishedChannels&offset=0",
      "rel": "last",
      "method": "GET",
      "mediaType": "application/json"
    }
  ]
}

Example 10:

List all promoted taxonomies including a link to the sub-resource categoryProperties for each taxonomy.

/content/management/api/v1.1/taxonomies?fields=categoryProperties

Response Body

{
  "hasMore": false,
  "offset": 0,
  "count": 3,
  "limit": 100,
  "items": [
    {
      "id": "5D5AF080B7824C49950443A7D51DE950",
      "name": "Taxonomy 1",
      "description": "",
      "shortName": "T1",
      "status": "promoted",
      "version": 4,
      "isPublishable": false,
      "isForSiteManagement": false,
      "createdBy": "cecusername",
      "createdDate": {
        "value": "2019-01-31T19:52:45.472Z",
        "timezone": "UTC"
      },
      "updatedBy": "cecusername",
      "updatedDate": {
        "value": "2019-02-01T17:49:43.854Z",
        "timezone": "UTC"
      },
      "categoryProperties": {
        "links": [
          {
            "href": "https://<hostname>/content/management/api/v1.1/taxonomies/5D5AF080B7824C49950443A7D51DE950/categoryProperties",
            "rel": "self",
            "method": "GET",
            "mediaType": "application/json"
          }
        ]
      },
      "links": [
        {
          "href": "https://<hostname>/content/management/api/v1.1/taxonomies/5D5AF080B7824C49950443A7D51DE950?fields=categoryProperties",
          "rel": "self",
          "method": "GET",
          "mediaType": "application/json"
        }
      ]
    },
    {
      "id": "22ED0446197F49B490619206DEC71482",
      "name": "Taxonomy 2",
      "description": "Some description",
      "shortName": "T2",
      "status": "promoted",
      "version": 5,
      "isPublishable": false,
      "isForSiteManagement": false,
      "createdBy": "cecusername",
      "createdDate": {
        "value": "2019-02-01T17:48:25.082Z",
        "timezone": "UTC"
      },
      "updatedBy": "cecusername",
      "updatedDate": {
        "value": "2019-02-01T17:49:52.936Z",
        "timezone": "UTC"
      },
      "categoryProperties": {
        "links": [
          {
            "href": "https://<hostname>/content/management/api/v1.1/taxonomies/22ED0446197F49B490619206DEC71482/categoryProperties",
            "rel": "self",
            "method": "GET",
            "mediaType": "application/json"
          }
        ]
      },
      "links": [
        {
          "href": "https://<hostname>/content/management/api/v1.1/taxonomies/22ED0446197F49B490619206DEC71482?fields=categoryProperties",
          "rel": "self",
          "method": "GET",
          "mediaType": "application/json"
        }
      ]
    },
    {
      "id": "D7969D6CA0D144AEA9CCA88BA6D2CF81",
      "name": "Taxonomy 3",
      "description": "Another description",
      "shortName": "T3",
      "status": "promoted",
      "version": 6,
      "isPublishable": false,
      "isForSiteManagement": false,
      "createdBy": "cecusername",
      "createdDate": {
        "value": "2019-02-01T17:49:08.832Z",
        "timezone": "UTC"
      },
      "updatedBy": "cecusername",
      "updatedDate": {
        "value": "2019-02-01T17:50:00.951Z",
        "timezone": "UTC"
      },
      "categoryProperties": {
        "links": [
          {
            "href": "https://<hostname>/content/management/api/v1.1/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81/categoryProperties",
            "rel": "self",
            "method": "GET",
            "mediaType": "application/json"
          }
        ]
      },
      "links": [
        {
          "href": "https://<hostname>/content/management/api/v1.1/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81?fields=categoryProperties",
          "rel": "self",
          "method": "GET",
          "mediaType": "application/json"
        }
      ]
    }
  ],
  "links": [
    {
      "href": "https://<hostname>/content/management/api/v1.1/taxonomies?fields=categoryProperties",
      "rel": "self",
      "method": "GET",
      "mediaType": "application/json"
    },
    {
      "href": "https://<hostname>/content/management/api/v1.1/taxonomies?fields=categoryProperties",
      "rel": "canonical",
      "method": "GET",
      "mediaType": "application/json"
    },
    {
      "href": "https://<hostname>/content/management/api/v1.1/metadata-catalog/taxonomies",
      "rel": "describedby",
      "method": "GET",
      "mediaType": "application/schema+json"
    },
    {
      "href": "https://<hostname>/content/management/api/v1.1/taxonomies?fields=categoryProperties&offset=0",
      "rel": "first",
      "method": "GET",
      "mediaType": "application/json"
    },
    {
      "href": "https://<hostname>/content/management/api/v1.1/taxonomies?fields=categoryProperties&offset=0",
      "rel": "last",
      "method": "GET",
      "mediaType": "application/json"
    }
  ]
}

Example 11:

List all promoted taxonomies including all the optional fields and a link to the sub-resource categoryProperties.

/content/management/api/v1.1/taxonomies?fields=all

Response Body

{
  "hasMore": false,
  "offset": 0,
  "count": 3,
  "limit": 100,
  "items": [
    {
      "id": "5D5AF080B7824C49950443A7D51DE950",
      "name": "Taxonomy 1",
      "description": "",
      "shortName": "T1",
      "status": "promoted",
      "version": 4,
      "isPublishable": true,
      "isForSiteManagement": false,
      "roleName": "manager",
      "availableStates": [
        {
          "status": "promoted",
          "version": 4,
          "published": true
        },
        {
          "status": "draft",
          "published": false
        }
      ],
      "publishedChannels": [
        {
          "id": "CC59073EACA4A56A990700ADEB643CAB64E62AA2CC55",
          "name": "Channel 02"
        },
        {
          "id": "CCD608830CFD886E62FC58DC2B89320BEA5A4052D0FC",
          "name": "Channel 01"
        }
      ],
      "createdBy": "cecusername",
      "createdDate": {
        "value": "2019-01-31T19:52:45.472Z",
        "timezone": "UTC"
      },
      "updatedBy": "cecusername",
      "updatedDate": {
        "value": "2019-02-01T17:49:43.854Z",
        "timezone": "UTC"
      },
      "categoryProperties": {
        "links": [
          {
            "href": "https://<hostname>/content/management/api/v1.1/taxonomies/5D5AF080B7824C49950443A7D51DE950/categoryProperties",
            "rel": "self",
            "method": "GET",
            "mediaType": "application/json"
          }
        ]
      },
      "links": [
        {
          "href": "https://<hostname>/content/management/api/v1.1/taxonomies/5D5AF080B7824C49950443A7D51DE950?fields=all",
          "rel": "self",
          "method": "GET",
          "mediaType": "application/json"
        }
      ]
    },
    {
      "id": "22ED0446197F49B490619206DEC71482",
      "name": "Taxonomy 2",
      "description": "Some description",
      "shortName": "T2",
      "status": "promoted",
      "version": 5,
      "isPublishable": false,
      "isForSiteManagement": false,
      "availableStates": [
        {
          "status": "promoted",
          "version": 5,
          "published": false
        },
        {
          "status": "draft",
          "published": false
        }
      ],
      "createdBy": "cecusername",
      "createdDate": {
        "value": "2019-02-01T17:48:25.082Z",
        "timezone": "UTC"
      },
      "updatedBy": "cecusername",
      "updatedDate": {
        "value": "2019-02-01T17:49:52.936Z",
        "timezone": "UTC"
      },
      "categoryProperties": {
        "links": [
          {
            "href": "https://<hostname>/content/management/api/v1.1/taxonomies/22ED0446197F49B490619206DEC71482/categoryProperties",
            "rel": "self",
            "method": "GET",
            "mediaType": "application/json"
          }
        ]
      },
      "links": [
        {
          "href": "https://<hostname>/content/management/api/v1.1/taxonomies/22ED0446197F49B490619206DEC71482?fields=all",
          "rel": "self",
          "method": "GET",
          "mediaType": "application/json"
        }
      ]
    },
    {
      "id": "D7969D6CA0D144AEA9CCA88BA6D2CF81",
      "name": "Taxonomy 3",
      "description": "Another description",
      "shortName": "T3",
      "status": "promoted",
      "version": 6,
      "isPublishable": true,
      "isForSiteManagement": false,
      "availableStates": [
        {
          "status": "promoted",
          "version": 6,
          "published": true
        },
        {
          "status": "draft",
          "published": false
        }
      ],
      "publishedChannels": [
        {
          "id": "CC59073EACA4A56A990700ADEB643CAB64E62AA2CC55",
          "name": "Channel 02"
        }
      ],
      "createdBy": "cecusername",
      "createdDate": {
        "value": "2019-02-01T17:49:08.832Z",
        "timezone": "UTC"
      },
      "updatedBy": "cecusername",
      "updatedDate": {
        "value": "2019-02-01T17:50:00.951Z",
        "timezone": "UTC"
      },
      "categoryProperties": {
        "links": [
          {
            "href": "https://<hostname>/content/management/api/v1.1/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81/categoryProperties",
            "rel": "self",
            "method": "GET",
            "mediaType": "application/json"
          }
        ]
      },
      "links": [
        {
          "href": "https://<hostname>/content/management/api/v1.1/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81?fields=all",
          "rel": "self",
          "method": "GET",
          "mediaType": "application/json"
        }
      ]
    }
  ],
  "links": [
    {
      "href": "https://<hostname>/content/management/api/v1.1/taxonomies?fields=all",
      "rel": "self",
      "method": "GET",
      "mediaType": "application/json"
    },
    {
      "href": "https://<hostname>/content/management/api/v1.1/taxonomies?fields=all",
      "rel": "canonical",
      "method": "GET",
      "mediaType": "application/json"
    },
    {
      "href": "https://<hostname>/content/management/api/v1.1/metadata-catalog/taxonomies",
      "rel": "describedby",
      "method": "GET",
      "mediaType": "application/schema+json"
    },
    {
      "href": "https://<hostname>/content/management/api/v1.1/taxonomies?fields=all&offset=0",
      "rel": "first",
      "method": "GET",
      "mediaType": "application/json"
    },
    {
      "href": "https://<hostname>/content/management/api/v1.1/taxonomies?fields=all&offset=0",
      "rel": "last",
      "method": "GET",
      "mediaType": "application/json"
    }
  ]
}

Example 12:

Returns a list of promoted taxonomies with permissions equal or higher than \"viewer\".

/content/management/api/v1.1/taxonomies?q=(roleName eq \"viewer\")&fields=all"

Response Body

{
  "hasMore": false,
  "offset": 0,
  "count": 3,
  "limit": 100,
  "items": [
    {
      "id": "5D5AF080B7824C49950443A7D51DE950",
      "name": "Taxonomy Manager 1",
      "description": "",
      "shortName": "T1",
      "status": "promoted",
      "version": 4,
      "isPublishable": false,
      "isForSiteManagement": false,
      "roleName": "manager",
      "createdBy": "cecusername",
      "createdDate": {
        "value": "2019-01-31T19:52:45.472Z",
        "timezone": "UTC"
      },
      "updatedBy": "cecusername",
      "updatedDate": {
        "value": "2019-02-01T17:49:43.854Z",
        "timezone": "UTC"
      },
      "links": [
        {
          "href": "https://<hostname>/content/management/api/v1.1/taxonomies/5D5AF080B7824C49950443A7D51DE950",
          "rel": "self",
          "method": "GET",
          "mediaType": "application/json"
        }
      ]
    },
    {
      "id": "22ED0446197F49B490619206DEC71482",
      "name": "Taxonomy Editor 2",
      "description": "Some description",
      "shortName": "T2",
      "status": "promoted",
      "version": 5,
      "isPublishable": false,
      "isForSiteManagement": false,
      "roleName": "editor",
      "createdBy": "cecusername",
      "createdDate": {
        "value": "2019-02-01T17:48:25.082Z",
        "timezone": "UTC"
      },
      "updatedBy": "cecusername",
      "updatedDate": {
        "value": "2019-02-01T17:49:52.936Z",
        "timezone": "UTC"
      },
      "links": [
        {
          "href": "https://<hostname>/content/management/api/v1.1/taxonomies/22ED0446197F49B490619206DEC71482",
          "rel": "self",
          "method": "GET",
          "mediaType": "application/json"
        }
      ]
    },
    {
      "id": "D7969D6CA0D144AEA9CCA88BA6D2CF81",
      "name": "Taxonomy Viewer 3",
      "description": "Another description",
      "shortName": "T3",
      "status": "promoted",
      "version": 6,
      "isPublishable": false,
      "isForSiteManagement": false,
      "roleName": "viewer",
      "createdBy": "cecusername",
      "createdDate": {
        "value": "2019-02-01T17:49:08.832Z",
        "timezone": "UTC"
      },
      "updatedBy": "cecusername",
      "updatedDate": {
        "value": "2019-02-01T17:50:00.951Z",
        "timezone": "UTC"
      },
      "links": [
        {
          "href": "https://<hostname>/content/management/api/v1.1/taxonomies/D7969D6CA0D144AEA9CCA88BA6D2CF81",
          "rel": "self",
          "method": "GET",
          "mediaType": "application/json"
        }
      ]
    }
  ],
  "links": [
    {
      "href": "https://<hostname>/content/management/api/v1.1/taxonomies",
      "rel": "self",
      "method": "GET",
      "mediaType": "application/json"
    },
    {
      "href": "https://<hostname>/content/management/api/v1.1/taxonomies",
      "rel": "canonical",
      "method": "GET",
      "mediaType": "application/json"
    },
    {
      "href": "https://<hostname>/content/management/api/v1.1/metadata-catalog/taxonomies",
      "rel": "describedby",
      "method": "GET",
      "mediaType": "application/schema+json"
    },
    {
      "href": "https://<hostname>/content/management/api/v1.1/taxonomies?offset=0",
      "rel": "first",
      "method": "GET",
      "mediaType": "application/json"
    },
    {
      "href": "https://<hostname>/content/management/api/v1.1/taxonomies?offset=0",
      "rel": "last",
      "method": "GET",
      "mediaType": "application/json"
    }
  ]
}

Back to Top