LogoLogo
  • General
    • Overview
    • Mode of Operation
    • Key Services and Logistics Requirements
  • Know Your Customer (KYC) FAQs
  • User Guide
    • General Product Information
    • Create Products
    • Product Image Requirements
    • Manage and Publish Products
    • Manage Stock and Prices
    • Orders and Shipments
    • User Management
  • API
    • Getting Started
      • API Authentication
      • Sandbox Environment
      • Make your first API request
    • Products
      • Get Products
      • Create and Update Products
      • Get Product Batch Results
      • Update Product Status (and Publish)
      • Get Product Status Update Batch Results
      • List Product Categories
      • List Product Attribute Groups
    • Stock and Prices
      • Update Stock
      • Get Stock Batch Results
      • Update Price
      • Get Price Batch Results
    • Orders and Shipment
      • Get Orders
      • Ship Order Items
      • Get Shipped Order Batch Results
      • Cancel Order Items
      • Get Cancelled Order Item Batch Results
      • Return Order Items
      • Get Returned Order Batch Results
    • Webhooks
      • Order Delegation Webhook
  • Shopify Plugin
    • Getting Started
      • Intro
      • Add Custom App to your Store
      • Sync your Shop in the Sellers Center
      • Product Preparations
      • Sync Products
      • Connect Products to the Seller Center
    • Order Handling
    • Additional Information
      • Permissions
      • Stock Safety Margin
      • Price Markup
On this page

Was this helpful?

Export as PDF
  1. API
  2. Products

List Product Categories

PreviousGet Product Status Update Batch ResultsNextList Product Attribute Groups

Last updated 1 month ago

Was this helpful?

List Categories

get
Authorizations
Query parameters
queryany ofOptional

Search term to filter items by path name

stringOptional
or
nullOptional
parent_categoryany ofOptional

Filter items by parent category ID

integer · min: 1Optional

ID (integer) of this property

Example: 1
or
nullOptional
pageinteger · min: 1Optional

Page number to retrieve items from

Default: 1
per_pageinteger · min: 1 · max: 100Optional

Number of items per page

Default: 20
Responses
200
OK
application/json
400
Bad Request
application/json
401
Unauthorized
application/json
get
GET /api/v1/categories/ HTTP/1.1
Host: 
X-API-Key: YOUR_API_KEY
Accept: */*
{
  "items": [
    {
      "id": 1,
      "name": "Caps",
      "path": "Fashion|Women|Caps",
      "parent_id": 123,
      "parent": 1
    }
  ],
  "pagination": {
    "per_page": 1,
    "page": 1,
    "pages": 1,
    "total": 1,
    "next": "text",
    "prev": "text"
  }
}