Skip to content

Data api categories list

Taku AMANO edited this page Jul 10, 2013 · 2 revisions

Categories: list

Retrieve a list of categories.

Request

HTTP Request

This method accepts GET only.

GET https://your-host/your-mt-api.cgi/v1/sites/{blog_id}/categories

Parameters

Method Parameters

Parameter Type Description
blog_id unsigned integer The blog ID.

Query Parameters

Parameter Type Description
sortBy string This is an optional parameter.
user_custom
(default) Sort order you specified on the Manage Categories screen.
label
Sort by the label of each categories.
sortOrder string This is an optional parameter.
ascend
(default) Return categories in ascending order.
descend
Return categories in descending order.

Request Body

Do not supply a request body.

Response

If successful, this method will return list of Categories resource as the response body.

Status Code

Code Description
200 no error
403 Do not have permission to retrieve the list of categories.
404 Site not found
Clone this wiki locally