---
title: "List help center categories (POST form)"
method: POST
path: "/help-categories"
tags: ["Support"]
---

# List help center categories (POST form)

`POST /help-categories`

## Request

- Base URL: `https://grape.cool/api/v1`
- URL: `https://grape.cool/api/v1/help-categories`
- Auth: none required

Returns the help center categories with the number of articles in each, so a follow up call can filter listHelpArticles. Identical to the GET operation; the query arguments move into a JSON body.

## Request body

- object

## Response `200`

Every category.

- object
  - `success` true, required
  - `data` HelpCategory[], required
    - `slug` string, required: Identifier for the category filter.
    - `name` string, required: Category name.
    - `description` string, required: What it covers.
    - `url` string, uri
    - `articleCount` integer: How many articles sit in this category.
  - `meta` Meta: Counts and echoed arguments that describe the payload.
    - `total` integer: How many items exist.
    - `returned` integer: How many items this response carries.
    - `query` string: The search term that was used.
    - `currency` string: ISO 4217 code the prices are quoted in.

## Other responses

- `400`: A parameter was missing or outside the allowed values.
- `404`: Nothing matches the identifier given.
- `429`: More than 1000 requests came from this IP address in an hour.
- `500`: The request could not be completed.

---

[API](https://skmtc.dev/grape/apis/grape-public-api.md) · [All operations](https://skmtc.dev/grape/apis/grape-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/grape/apis/grape-public-api/revisions/16061cbac2d4?raw)