WP REST API v2 Documentation

Schema

The schema defines all the fields that exist for a category object.

`id` integer	Unique identifier for the term. Read only Context: `view`, `embed`, `edit`
`count` integer	Number of published posts for the term. Read only Context: `view`, `edit`
`description` string	HTML description of the term. Context: `view`, `edit`
`link` string, uri	URL of the term. Read only Context: `view`, `embed`, `edit`
`name` string	HTML title for the term. Context: `view`, `embed`, `edit`
`slug` string	An alphanumeric identifier for the term unique to its type. Context: `view`, `embed`, `edit`
`taxonomy` string	Type attribution for the term. Read only Context: `view`, `embed`, `edit` One of: `category`, `post_tag`, `nav_menu`, `link_category`, `post_format`
`parent` integer	The parent term ID. Context: `view`, `edit`
`meta` object	Meta fields. Context: `view`, `edit`

$ curl -X OPTIONS -i http://demo.wp-api.org/wp-json/wp/v2/categories

`context`	Scope under which the request is made; determines fields present in response. Default: `view` One of: `view`, `embed`, `edit`
`page`	Current page of the collection. Default: `1`
`per_page`	Maximum number of items to be returned in result set. Default: `10`
`search`	Limit results to those matching a string.
`exclude`	Ensure result set excludes specific IDs. Default:
`include`	Limit result set to specific IDs. Default:
`order`	Order sort attribute ascending or descending. Default: `asc` One of: `asc`, `desc`
`orderby`	Sort collection by term attribute. Default: `name` One of: `id`, `include`, `name`, `slug`, `term_group`, `description`, `count`
`hide_empty`	Whether to hide terms not assigned to any posts.
`parent`	Limit result set to terms assigned to a specific parent.
`post`	Limit result set to terms assigned to a specific post.
`slug`	Limit result set to terms with a specific slug.

GET /wp/v2/categories

$ curl http://demo.wp-api.org/wp-json/wp/v2/categories

context

Scope under which the request is made; determines fields present in response.

Default: view

One of: view, embed, edit

GET /wp/v2/categories/<id>

$ curl http://demo.wp-api.org/wp-json/wp/v2/categories/<id>

`description`	HTML description of the term.
`name`	HTML title for the term. Required: true
`slug`	An alphanumeric identifier for the term unique to its type.
`parent`	The parent term ID.
`meta`	Meta fields.

POST /wp/v2/categories

`description`	HTML description of the term.
`name`	HTML title for the term.
`slug`	An alphanumeric identifier for the term unique to its type.
`parent`	The parent term ID.
`meta`	Meta fields.

POST /wp/v2/categories/<id>

force

Required to be true, as terms do not support trashing.

DELETE /wp/v2/categories/<id>

$ curl -X DELETE http://demo.wp-api.org/wp-json/wp/v2/categories/<id>