> For the complete documentation index, see [llms.txt](https://mastodon.gitbook.io/mastodon/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://mastodon.gitbook.io/mastodon/entities/list.md).

# List

## Example

```javascript
  {
    "id": "12249",
    "title": "Friends"
  }
```

## Required attributes

### `id`

**Description:** The internal database ID of the list.\
**Type:** String (cast from an integer, but not guaranteed to be a number)\
**Version history:** Added in 2.1.0

### `title`

**Description:** The user-defined title of the list.\
**Type:** String\
**Version history:** Added in 2.1.0

## See also

{% content-ref url="/pages/-LqIeukKIQ-tdii6gHgq" %}
[lists](/mastodon/methods/timelines/lists.md)
{% endcontent-ref %}

{% embed url="<https://github.com/tootsuite/mastodon/blob/master/app/serializers/rest/list_serializer.rb>" %}
app/serializers/rest/list\_serializer.rb
{% endembed %}