# Get a category

**Publié le** : 2026-05-08
**Catégorie** : Core CMS

## `GET /categories/:id`

**Get a category**

Returns a single category with its parent information and content count.

Required permissions: `categories.view`

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `id` | path | string | Yes | Unique identifier |


### Responses

| Status | Description |
| --- | --- |
| `200` | Successful response |
| `401` | Unauthorized — invalid or missing API token |
| `403` | Forbidden — insufficient permissions |
| `404` | Not found |


### Examples

```bash
curl https://api.lynkow.com/v1/categories/1 \
  -H "Authorization: Bearer $API_TOKEN"
```

### Response Example

```json
{
  "id": 1,
  "name": "Tutorials",
  "slug": "tutorials",
  "description": "Step-by-step guides and how-tos",
  "parentId": null,
  "locale": "en",
  "contentCount": 12,
  "parent": null,
  "contents": {
    "data": [
      {
        "id": 42,
        "title": "Getting Started with Lynkow",
        "slug": "getting-started-with-lynkow",
        "status": "published"
      }
    ],
    "meta": {
      "total": 12,
      "perPage": 15,
      "currentPage": 1,
      "lastPage": 1
    }
  },
  "createdAt": "2025-01-10T09:00:00.000Z",
  "updatedAt": "2025-02-20T16:45:00.000Z"
}
```

---