Display categories and their subcategories in Magento using REST API

There is indeed still nothing to be found either in Magento 1.x API guide either in the code.

You can clearly see in the folder structure of the Mage_Catalog module that the model representing categories are still only sub models of the product, so it's main goal is still "only" to be able to know in which categories a specific product is linked to.

Magento Folder Structure for REST API Model

And the code of this category model being of class Mage_Catalog_Model_Api2_Product_Category_Rest doesn't look like anything as changed from the previous answer, sadly (around line 61 in the latest version 1.9.2.4) :

protected function _retrieveCollection()
{
    $return = array();

    foreach ($this->_getCategoryIds() as $categoryId) {
        $return[] = array('category_id' => $categoryId);
    }
    return $return;
}

And I am unsure if Magento is still going to put any effort in REST API on the version 1.x of the framework.

Although there seems to be hope in Magento 2.x API list listing those available methods :

DELETE /V1/categories/:categoryId
GET /V1/categories/:categoryId
POST /V1/categories
GET /V1/categories
PUT /V1/categories/:id
PUT /V1/categories/:categoryId/move

Also the code offers possibilities to get the categories tree.
See here and there.

So it is definitely something possible under Magento 2.x


/api/rest/products/:productId/categories

This should retrieve a list of categories assigned to a specific product. Unfortunately, this won't lead you to the elegant solution you deserve.

If you want a list of categories you may have to use the soap api to retrieve the categories using the catalog_categories.tree method. I realize "use some other api" is the worst kind of answer but, it is what Magento currently offers.

The alternative is to extend the stock api with your own restful patchwork, but, life is short.

If you really want to do something like that then, this other Stack Overflow question will help get you started: Create new magento Rest api to get category list in magento