# Retrieve a Category

> Returns one Category with its descriptive metadata and Metadata Images.

`GET /categories/{id}` on `https://api.mediux.io`

## Parameters

- `id` (path, integer, required): The Category's numeric Mediux ID.

## Responses

### 200

The Category.

- `data` (object, required)
  - `kind` (string, required): One of "category".
  - `id` (integer, required)
  - `name` (string, required)
  - `categoryGroup` (string, required): One of "genres", "subgenres", "themes", "sports", "occasions", "countries", "technologies", "gameGenres", "gameThemes", "gameModes", "gamePerspectives", "other".
  - `description` (string, nullable, required)

### 304

Not modified. The `If-None-Match` validator still matches; no body.

### 400

The path is not a valid route, or the request carried a query string or body.

### 404

The resource does not exist or is not public.

### 405

Only `GET`, `HEAD` and `OPTIONS` are supported.

### 429

Too many cache misses from this address. Retry after the `Retry-After` delay.

### 503

Temporarily unavailable. Retry after the `Retry-After` delay.

## Example response (200)

```json
{
  "data": {
    "kind": "category",
    "id": 1,
    "name": "Action",
    "categoryGroup": "genres",
    "description": null
  }
}
```
