Skip to main content
Information about metadata taxonomies can be retrieved using the namespace, taxonomy_key, node_id, and field_key.

​
List metadata taxonomy nodes

Retrieve a list of nodes defined within a metadata taxonomy. Nodes are the hierarchical data available in your taxonomy. To list all nodes, call the GET /metadata_taxonomies/{namespace}/{taxonomy_key}/nodes API endpoint. 

curl --request GET \ 
  --url https://api.box.com/2.0/metadata_taxonomies/{namespace}/{taxonomy_key}/nodes \ 
  --header 'Authorization: Bearer <token>'
Additional information is available for the namespace and taxonomy_key of a taxonomy.

​
Get a metadata taxonomy by key

Get the full definition of a specific taxonomy including how many levels it has, and what the display names and descriptions of those levels are. To get information by taxonomy key, call the GET /metadata_taxonomies/{namespace}/{taxonomy_key} API endpoint. 

curl --request GET \ 
  --url https://api.box.com/2.0/metadata_taxonomies/{namespace}/{taxonomy_key} \ 
  --header 'Authorization: Bearer <token>'
Additional information is available for the namespace and taxonomy_key of a taxonomy.

​
Get a metadata taxonomy node by ID

You can fetch a specific node and its metadata using its ID. Nodes are the hierarchical data available in your taxonomy. To get a node, call the GET /metadata_taxonomies/{namespace}/{taxonomy_key}/nodes/{node_id} API endpoint. 

curl --request GET \ 
  --url https://api.box.com/2.0/metadata_taxonomies/{namespace}/{taxonomy_key}/nodes/{node_id} \ 
  --header 'Authorization: Bearer <token>'
Additional information is available for the namespace, taxonomy_key, and node_id of a taxonomy.

​
List metadata taxonomy field options

Retrieve the nodes that serve as selectable options for a taxonomy field, as defined inside a metadata template. To list possible values for taxonomy nodes in a template, call the GET /metadata_templates/{namespace}/{template_key}/fields/{field_key}/options API endpoint. 

curl --request GET \  
  --url https://api.box.com/2.0/metadata_templates/{namespace}/{template_key}/fields/{field_key}/options \ 
  --header 'Authorization: Bearer <token>'
Additional information is available for the namespace, template_key, and field_key of a taxonomy.