Medusa
  1. Product Categories
Medusa
  • Back to home
  • Store API
  • Carts
    • Auth
      • Customer Login (JWT)
      • Customer Login (JWT)
      • Check if Email Exists
      • Get Current Customer
      • Customer Log out
      • Customer Login
    • Create Payment Sessions
      POST
    • Refresh a Payment Session
      POST
    • Create a Cart
      POST
    • Complete a Cart
      POST
    • Select a Payment Session
      POST
    • Delete a Payment Session
      DELETE
    • Update a Payment Session
      POST
    • Get a Cart
      GET
    • Update a Cart
      POST
    • Add Shipping Method
      POST
    • Update a Line Item
      POST
    • Delete a Line Item
      DELETE
    • Add a Line Item
      POST
    • Calculate Cart Taxes
      POST
    • Remove Discount
      DELETE
  • Customers
    • Request Password Reset
      POST
    • Get Saved Payment Methods
      GET
    • Add a Shipping Address
      POST
    • Update Customer
      POST
    • Get a Customer
      GET
    • Update a Shipping Address
      POST
    • Delete an Address
      DELETE
    • Create a Customer
      POST
    • Reset Password
      POST
    • List Orders
      GET
  • Gift Cards
    • Get Gift Card by Code
  • Orders
    • 77
      • Claim Order
    • Verify Order Claim
    • Get an Order
    • Look Up an Order
    • Get by Cart ID
  • Order Edits
    • Complete an Order Edit
    • Retrieve an Order Edit
    • Decline an Order Edit
  • Payment Collections
    • Authorize Payment Session
    • Authorize Payment Sessions
    • Refresh a Payment Session
    • Get a PaymentCollection
    • Manage Payment Sessions
    • Create a Payment Session
  • Products
    • Search Products
    • List Products
    • Get a Product
  • Product Variants
    • Get a Product Variant
    • Get Product Variants
  • Product Tags
    • List Product Tags
  • Product Categories
    • List Product Categories
      GET
    • Get a Product Category
      GET
  • Product Collections
    • Get a Collection
    • List Collections
  • Product Types
    • List Product Types
  • Regions
    • List Regions
    • Get a Region
  • Returns
    • Create Return
  • Return Reasons
    • List Return Reasons
    • Get a Return Reason
  • Shipping Options
    • List for Cart
    • Get Shipping Options
  • Swaps
    • Get by Cart ID
    • Create a Swap
  1. Product Categories

Get a Product Category

GET
/store/product-categories/{id}
Store API/Product CategoriesProduct Categories
Retrieve a Product Category's details.

Request

Path Params
id
string 
required
The ID of the Product Category
Query Params
fields
string 
optional
Comma-separated fields that should be expanded in the returned product category.
expand
string 
optional
Comma-separated relations that should be expanded in the returned product category.

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET '/store/product-categories/'

Responses

🟢200OK
application/json
Body
The product category's details.
product_category
object (Product Category) 
required
A product category can be used to categorize products into a hierarchy of categories.
id
string 
required
The product category's ID
Example:
pcat_01G2SG30J8C85S4A5CHM2S1NS2
name
string 
required
The product category's name
Example:
Regular Fit
description
string 
optional
The product category's description.
Default:
handle
string 
required
A unique string that identifies the Product Category - can for example be used in slug structures.
Example:
regular-fit
mpath
string  | null 
required
A string for Materialized Paths - used for finding ancestors and descendents
Example:
pcat_id1.pcat_id2.pcat_id3
is_internal
boolean 
required
A flag to make product category an internal category for admins
Default:
false
is_active
boolean 
required
A flag to make product category visible/hidden in the store front
Default:
false
rank
integer 
optional
An integer that depicts the rank of category in a tree node
Default:
0
parent_category_id
string  | null 
required
The ID of the parent category.
Default:
null
parent_category
object  | null 
optional
The details of the parent of this category.
created_at
string <date-time>
required
The date with timezone at which the resource was created.
updated_at
string <date-time>
required
The date with timezone at which the resource was updated.
category_children
array [object] 
required
The details of the category's children.
products
array [object] 
optional
The details of the products that belong to this category.
metadata
object  | null 
required
An optional key-value map with additional details
Example:
{"car":"white"}
Example
{
    "product_category": {
        "id": "pcat_01G2SG30J8C85S4A5CHM2S1NS2",
        "name": "Regular Fit",
        "description": "",
        "handle": "regular-fit",
        "mpath": "pcat_id1.pcat_id2.pcat_id3",
        "is_internal": false,
        "is_active": false,
        "rank": 0,
        "parent_category_id": null,
        "parent_category": {},
        "created_at": "2019-08-24T14:15:22Z",
        "updated_at": "2019-08-24T14:15:22Z",
        "category_children": [
            {}
        ],
        "products": [
            {}
        ],
        "metadata": {
            "car": "white"
        }
    }
}
🟠400Client Error or Multiple Errors
🟠401User is not authorized. Must log in first
🟠404Not Found Error
🟠409Invalid State Error
🟠422Invalid Request Error
🔴500Server Error
Modified at 2024-05-23 07:10:14
Previous
List Product Categories
Next
Get a Collection
Built with