> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cocartapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Product Categories

> Returns a list of product categories.



## OpenAPI

````yaml api-reference/v1/openapi-products-v1.yaml get /products/categories
openapi: 3.0.3
info:
  title: CoCart - Products API v1
  version: 4.6.0
  description: >-
    API for managing WooCommerce products, variations, categories, tags,
    attributes, and reviews
  termsOfService: http://cocartapi.com/terms-of-conditions-polar/
  contact:
    email: support@cocartapi.com
  license:
    name: GNU General Public License v3.0
    url: http://www.gnu.org/licenses/gpl-3.0.html
servers:
  - url: '{protocol}://{host}/wp-json/cocart/v1'
    description: API v1
    variables:
      protocol:
        enum:
          - http
          - https
        default: https
      host:
        default: example-store.com
        description: Your store domain
security: []
tags:
  - name: products
    description: Operations for managing products
  - name: product-variations
    description: Operations for managing product variations
  - name: product-categories
    description: Operations for managing product categories
  - name: product-tags
    description: Operations for managing product tags
  - name: product-attributes
    description: Operations for managing product attributes
  - name: product-attribute-terms
    description: Operations for managing product attribute terms
  - name: product-reviews
    description: Operations for managing product reviews
externalDocs:
  description: Find out more about CoCart API
  url: https://docs.cocartapi.com
paths:
  /products/categories:
    get:
      tags:
        - product-categories
      summary: Get product categories
      description: Returns a list of product categories.
      parameters:
        - name: context
          in: query
          description: >-
            Scope under which the request is made; determines fields present in
            response.
          schema:
            type: string
            enum:
              - view
              - embed
            default: view
          required: false
        - name: page
          in: query
          description: Current page of the collection.
          schema:
            type: integer
            default: 1
          required: false
        - name: per_page
          in: query
          description: Maximum number of items to be returned in result set.
          schema:
            type: integer
            default: 10
            maximum: 100
          required: false
        - name: search
          in: query
          description: Limit results to those matching a string.
          schema:
            type: string
          required: false
        - name: exclude
          in: query
          description: Ensure result set excludes specific IDs.
          schema:
            type: array
            items:
              type: integer
          required: false
        - name: include
          in: query
          description: Limit result set to specific IDs.
          schema:
            type: array
            items:
              type: integer
          required: false
        - name: offset
          in: query
          description: Offset the result set by a specific number of items.
          schema:
            type: integer
          required: false
        - name: order
          in: query
          description: Order sort attribute ascending or descending.
          schema:
            type: string
            enum:
              - asc
              - desc
            default: asc
          required: false
        - name: orderby
          in: query
          description: Sort collection by object attribute.
          schema:
            type: string
            enum:
              - id
              - include
              - name
              - slug
              - term_group
              - description
              - count
            default: name
          required: false
        - name: hide_empty
          in: query
          description: Whether to hide resources not assigned to any products.
          schema:
            type: boolean
            default: false
          required: false
        - name: parent
          in: query
          description: Limit result set to resources assigned to a specific parent.
          schema:
            type: integer
          required: false
        - name: product
          in: query
          description: Limit result set to resources assigned to a specific product.
          schema:
            type: integer
          required: false
        - name: slug
          in: query
          description: Limit result set to resources with a specific slug.
          schema:
            type: string
          required: false
      responses:
        '200':
          description: List of product categories.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ProductCategory'
        '400':
          description: Bad request - invalid parameters.
components:
  schemas:
    ProductCategory:
      type: object
      properties:
        id:
          type: integer
          description: Unique identifier for the category.
        name:
          type: string
          description: Category name.
        slug:
          type: string
          description: Category slug.
        parent:
          type: integer
          description: Parent category ID.
        description:
          type: string
          description: Category description.
        display:
          type: string
          description: Category display type.
        image:
          type: object
          properties:
            id:
              type: integer
              description: Image ID.
            src:
              type: string
              description: Image URL.
            name:
              type: string
              description: Image name.
            alt:
              type: string
              description: Image alt text.
        menu_order:
          type: integer
          description: Menu order.
        count:
          type: integer
          description: Number of products in the category.
        links:
          type: object
          properties:
            self:
              type: array
              items:
                type: object
                properties:
                  href:
                    type: string
                    description: Link URL.
            collection:
              type: array
              items:
                type: object
                properties:
                  href:
                    type: string
                    description: Link URL.
            up:
              type: array
              items:
                type: object
                properties:
                  href:
                    type: string
                    description: Link URL.

````