# Categorieën

> Bekijk de categorieën van je catalogus

- Pagina: https://tbit.app/nl/docs/api/categories
- Basis-URL: `https://rest-api.tbit.app/v1`
- Authenticatie: header `X-API-Key` met je sleutel bij elk verzoek (de voorbeelden lezen hem uit de omgevingsvariabele `TBIT_API_KEY`)

## Overzicht

Categorieën zijn facetten die worden afgeleid uit de category_tags van je actieve producten. Elke categorie bevat het aantal producten met dat label. Gebruik de naam van de categorie als parameter tag wanneer je producten opvraagt.

## Endpoints

| Methode | Pad | Beschrijving |
| --- | --- | --- |
| `GET` | `/v1/categories` | Categoriefacetten opvragen |

## Categorieën opvragen

`GET /v1/categories`

```bash
curl "https://rest-api.tbit.app/v1/categories" \
  -H "X-API-Key: $TBIT_API_KEY"
```

## Responseformaat

De categorieën met hun aantal producten, plus het totaal aantal actieve artikelen in de catalogus:

```json
{
  "data": {
    "categories": [
      { "name": "fiestas", "count": 42 },
      { "name": "infantil", "count": 27 },
      { "name": "decoracion", "count": 18 }
    ],
    "total_items": 134
  }
}
```