Skip to main content
GET
/
admin
/
product-categories
/
{id}
JS SDK
import Medusa from "@medusajs/js-sdk"

export const sdk = new Medusa({
  baseUrl: import.meta.env.VITE_BACKEND_URL || "/",
  debug: import.meta.env.DEV,
  auth: {
    type: "session",
  },
})

sdk.admin.productCategory.retrieve("pcat_123")
.then(({ product_category }) => {
  console.log(product_category)
})
{
  "product_category": {
    "category_children": [
      {}
    ],
    "parent_category": {},
    "name": "<string>",
    "description": "<string>",
    "id": "<string>",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "handle": "<string>",
    "deleted_at": "2023-11-07T05:31:56Z",
    "is_active": true,
    "is_internal": true,
    "rank": 123,
    "parent_category_id": "<string>",
    "products": [
      {}
    ],
    "metadata": {}
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
id
string
required

The product category's ID.

Query Parameters

​
fields
string

Comma-separated fields that should be included in the returned data. if a field is prefixed with + it will be added to the default fields, using - will remove it from the default fields. without prefix it will replace the entire default fields. This API route restricts the fields that can be selected. Learn how to override the retrievable fields in the Retrieve Custom Links documentation.

​
include_ancestors_tree
boolean

Whether to retrieve the category's parent. If you enable this, add to the fields query parameter parent_category to set the parent of a category in this field. You can either pass *parent_category to retreieve the fields of all parent categories, or select specific fields to make the response size smaller. For example, fields=parent_category.id,parent_category.name.

​
include_descendants_tree
boolean

Whether to retrieve a list of child categories. If you enable this, add to the fields query parameter category_children to set the children of a category in this field. You can either pass *category_children to retreieve the fields of all child categories, or select specific fields to make the response size smaller. For example, fields=category_children.id,category_children.name.

​
is_internal
boolean

Filter by whether the product category is internal.

​
is_active
boolean

Filter by whether the product category is active.

​
q
string

Apply a search query to the product category's searchable properties.

​
id

Filter by the product category's ID.

​
name

Filter by the product category's name.

​
description

Filter by the product category's description.

​
parent_category_id

Retrieve the categories of a given parent category's ID.

​
handle

Filter by the product category's handle.

​
created_at
created_at · object

Filter by the category's creation date.

​
updated_at
updated_at · object

Filter by the category's update date.

​
deleted_at
deleted_at · object

Filter by the category's deletion date.

​
limit
number

Limit the number of items returned in the list.

​
offset
number

The number of items to skip when retrieving a list.

​
order
string

The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with -.

​
with_deleted
boolean

The product category's with deleted.

​
$and
$and · object[]

Join query parameters with an AND condition. Each object's content is the same type as the expected query parameters.

​
$or
$or · object[]

Join query parameters with an OR condition. Each object's content is the same type as the expected query parameters.

Response

OK

The product category's details.

​
product_category
object
required

The product category's details.