# Introduction

## Category model

### Example

```json
{
   "id": 15,
   "name": "News",
   "position": 1,
   "created_at": "2021-07-14T12:54:07.076Z"
}
```

### Definition

Key | Type | Optional | Description
--------- | --------- | --------- | ---------
id | integer | no |
name | string | no |
position | string | yes | position on the list
created_at | datetime | no | Time of creation

## Category with articles model

### Example

```json
{
    "id": 10,
    "name": "News",
    "position": 2,
    "created_at": "2021-12-09T16:05:15.233Z",
    "active": true,
    "articles": [
        {
            "id": 16,
            "category_id": 10,
            "status": "published",
            "pinned": false,
            "title": "Title",
            "description": "<html>Html content</html>",
            "lead": null,
            "image_url": "http://image.url",
            "published_at": "2021-11-22T13:30:39.152Z",
            "created_at": "2021-08-27T10:37:50.306Z",
            "position": 1
        },
        ...
    ]
 }
```

### Definition

Key | Type | Optional | Description
--------- | --------- | --------- | ---------
id | integer | no |
name | string | yes |
position | integer | yes |
created_at | datetime | no | Time of creation
active | bool | no |
articles | array | no | Array of [Articles](doc-341721#article-model)