---
title: "List Categories"
method: GET
path: "/v3/articles/categories"
tags: ["Threat Briefs"]
---

# List Categories

`GET /v3/articles/categories`

Returns the list of available article categories.

## Response `200`

List of article categories.

- ArticleCategory[]
  - `id` string, uuid — Unique category identifier.
  - `label` string — Display label for the category.
  - `value` string — Machine-readable category value.
  - `color` string — Hex color code for the category.

## Other responses

- `401` — Unauthorized. Please check your API key.
- `403` — Forbidden - request is not authorized due to an invalid API key or plan limitations. If due to plan limitations, contact sales@greynoise.io to upgrade your plan and unlock full results.
- `429` — Too many requests. You've hit the rate-limit.
- `500` — Unexpected error

---

[API](https://skmtc.dev/greynoise/apis/greynoise-api.md) · [All operations](https://skmtc.dev/greynoise/apis/greynoise-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/greynoise/greynoise-api/revisions/30942574656d/schema)