# Custom Lists

A **custom lists** object provides information on your custom lists. Custom lists can be added and managed through the [custom lists page](https://portal.complycube.com/tools/customLists).

The API allows you to retrieve custom lists.

[Learn more about ComplyCube Custom Lists.](https://app.gitbook.com/s/KyFKMqftsmT6qln9zo5y/watchlist-pep-and-adverse-media/custom-lists)

{% hint style="info" %}
This is service is only available through our **Enterprise Plan**. Get in touch with your Account Manager or [contact us](https://www.complycube.com/sales) to enable it.
{% endhint %}

### The Custom List Object

<table><thead><tr><th width="224.39999999999998">Attribute</th><th width="96">Type</th><th>Description</th></tr></thead><tbody><tr><td><code>id</code></td><td>string</td><td>The unique identifier for a custom list.</td></tr><tr><td><code>name</code></td><td>string</td><td>The custom list's name.</td></tr><tr><td><code>description</code></td><td>string</td><td>The custom list's description.</td></tr><tr><td><code>stats</code></td><td>object</td><td>Details about the number of entities in the custom list. Also, see the <a href="#the-stats-object">stats</a> object below.</td></tr><tr><td><code>createdAt</code></td><td>string</td><td>The date and time when the custom list was created.</td></tr><tr><td><code>updatedAt</code></td><td>string</td><td>The date and time when the custom list was updated.</td></tr></tbody></table>

### The `stats` object

<table><thead><tr><th width="223">Attribute</th><th width="96.4">Type</th><th>Description</th></tr></thead><tbody><tr><td><code>personCount</code></td><td>number</td><td>The number of persons in the custom list.</td></tr><tr><td><code>companyCount</code></td><td>number</td><td>The number of companies in the custom list.</td></tr></tbody></table>