# `GET /category/{id}/articles`

Protected. Requires a valid session cookie (`credentials: 'include'`).

Articles in category

Returns articles in a category the user is authorized for, sorted alphabetically by name. By default includes child articles (variants); pass `includeChildren=false` to omit them. Each article includes `childCount` (the number of its child articles) and small thumbnail fields (`smallThumbW`, `smallThumbH`, `smallThumbBinary`).

## Path parameters

| Param | Required | Type | Description |
|-------|----------|------|-------------|
| `id` | yes | integer | Category id |

## Query parameters

| Param | Required | Type | Description |
|-------|----------|------|-------------|
| `includeChildren` | no | boolean | When true (default), includes child articles (variants) alongside parent articles. Set to false to omit child articles. |

## Response `200`

Articles list

```json
{
  "articles": [
    {
      "id": 1,
      "sku": "…",
      "name": "…",
      "slug": "…",
      "net": 1,
      "taxRate": 1,
      "track_stock": true,
      "optionsCount": 1,
      "articleListCount": 1,
      "childCount": 1,
      "parentArticleId": 1,
      "parentSku": "…",
      "fullHash": "…",
      "thumbW": 1,
      "thumbH": 1,
      "thumbHash": "…",
      "smallThumbW": 1,
      "smallThumbH": 1,
      "smallThumbBinary": "…",
      "brand": {
        "id": 1,
        "name": "…",
        "fullHash": "…",
        "thumbW": 1,
        "thumbH": 1,
        "thumbHash": "…"
      },
      "articlewarehousesummary": [
        {
          "id": 1,
          "articleId": 1,
          "article_id": 1,
          "warehouseId": 1,
          "warehouse_id": 1,
          "warehouseName": "…",
          "stock": 1
        }
      ],
      "warehouses": [
        {
          "id": 1,
          "name": "…",
          "stock": 1
        }
      ]
    }
  ]
}
```

## Errors

| Status | Description |
|--------|-------------|
| 400 | Invalid id — `{"error":"…"}` |
| 401 | Unauthorized — `{"error":"…"}` |
| 403 | Not authorized — `{"error":"…"}` |

---

_Generated from `@openapi` JSDoc. Do not edit by hand — run `npm run docs:api`._