---
title: "List all categories used in templates"
method: GET
path: "/templates/categories"
tags: ["Template"]
---

# List all categories used in templates

`GET /templates/categories`

## Request

- Base URL: `https://api.carbone.io`
- URL: `https://api.carbone.io/templates/categories`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/carbone/apis/carbone-api/docs/templates/categories/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve a list of all categories used in **deployed** templates, sorted by name. Categories function similarly to folders, allowing you to group and organize your templates effectively (e.g. "customer-x", "project-2026", "finances").

Practical Usage:
- **Uploading a Template:** When uploading a template, you can specify a category.
- **Updating a Template:** You can add or modify the category when updating template metadata.
- **Listing Templates:** You can filter templates by category to quickly find that are relevant to a specific function or type.

## Headers

- `carbone-version` '5' | '4' | '3' | 'staging', required

## Response `200`

List of categories used in templates.

- object
  - `success` boolean
  - `data` object[]
    - `name` string

## Other responses

- `400`: The template database could not be read.
- `401`: Unauthorized, please provide a correct API key on the `Authorization` header. The API key is available on your Carbone account: https://account.carbone.io.
- `500`: Server or Database Error.
- `501`: Carbone On-Premise only: this endpoint needs the template database, and the server runs in stateless mode (no database).

## Changes

- **2026-11-06** `c06cc573e3b0`: 2 breaking, 7 info
  - the `carbone-version` request header's property undefined was restricted to a list of enum values
  - the `header` request parameter `carbone-version` was restricted to a list of enum values
  - added the new enum value `3` to the `header` request parameter `carbone-version`
  - added the new enum value `4` to the `header` request parameter `carbone-version`
  - …5 more

[Operation history](https://skmtc.dev/carbone/apis/carbone-api/changes/templates/categories/get.md)

---

[API](https://skmtc.dev/carbone/apis/carbone-api.md) - [All operations](https://skmtc.dev/carbone/apis/carbone-api/llms.txt) - [OpenAPI document](https://skmtc.dev/carbone/apis/carbone-api/revisions/c06cc573e3b0?raw)