`/wp/v2/taxonomies`

Namespace: wp/v2
Route: /wp/v2/taxonomies

Routes

  • Collection: /wp/v2/taxonomies
  • Single: /wp/v2/taxonomies/{taxonomy}

HTTP Methods

Collection methods: GET

Single methods: GET

Request Parameters

Collection GET

ParameterTypeRequiredDefaultDescription
contextstringfalseviewScope under which the request is made; determines fields present in response.
typestringfalseLimit results to taxonomies associated with a specific post type.

Single GET

ParameterTypeRequiredDefaultDescription
taxonomystringfalseAn alphanumeric identifier for the taxonomy.
contextstringfalseviewScope under which the request is made; determines fields present in response.

Response Schema (Item)

FieldTypeDescription
capabilitiesobjectAll capabilities used by the taxonomy. (read-only)
descriptionstringA human-readable description of the taxonomy. (read-only)
hierarchicalbooleanWhether or not the taxonomy should have children. (read-only)
labelsobjectHuman-readable labels for the taxonomy for various contexts. (read-only)
namestringThe title for the taxonomy. (read-only)
slugstringAn alphanumeric identifier for the taxonomy. (read-only)
show_cloudbooleanWhether or not the term cloud should be displayed. (read-only)
typesarrayTypes associated with the taxonomy. (read-only)
rest_basestringREST base route for the taxonomy. (read-only)
rest_namespacestringREST namespace route for the taxonomy. (read-only)
visibilityobjectThe visibility settings for the taxonomy. (read-only)

Authentication

  • Read: public; no write methods.

Example Requests

bash
curl -X GET "https://wordpress.org/news/wp-json/wp/v2/taxonomies"
bash
curl -X GET "https://wordpress.org/news/wp-json/wp/v2/taxonomies/category"

Example Response (trimmed)

json
{
  "id": 1,
  "_links": {
    "self": [{ "href": "/wp/v2/taxonomies/1" }]
  }
}