Retrieve a Category in Storefront

In this document, learn how to retrieve a product category and its details in the storefront.

There are two ways to retrieve a product category:

  • Retrieve a category by its ID.
  • Retrieve a category by its handle field. This is useful if you're creating human-readable URLs in your storefront.

Retrieve a Product Category by ID#

To retrieve a product category by its ID, send a request to the Get a Product Category API route:

The response has a product_category field, which is a product category object.


Retrieve a Product Category by Handle#

To retrieve a product by its handle, send a request to the List Product Categories API route passing it the handle query parameter:

Was this page helpful?
Edit this page
Ask Anything
FAQ
What is Medusa?
How can I create a module?
How can I create a data model?
How do I create a workflow?
How can I extend a data model in the Product Module?
Recipes
How do I build a marketplace with Medusa?
How do I build digital products with Medusa?
How do I build subscription-based purchases with Medusa?
What other recipes are available in the Medusa documentation?
Chat is cleared on refresh
Line break