> ## Documentation Index
> Fetch the complete documentation index at: https://docs.superoffice.com/llms.txt
> Use this file to discover all available pages before exploring further.

# lists

> List provider for the Heading table. While this table looks like an MDO table, it lacks the standardized grouplink and headinglink companion tables for good reason, since it is the heading table itself.

## "lists" MDO List

List provider for the Heading table. While this table looks like an MDO table,
it lacks the standardized grouplink and headinglink companion tables for good reason,
since it is the heading table itself.

Implemented by the <see cref="T:SuperOffice.CRM.Lists.ListsListProvider">ListsListProvider</see> class.
The name of the MDO list is 'lists'.

## Additional Attributes

| Description                    | Name                 | Example Value |
| ------------------------------ | -------------------- | ------------- |
| Include deleted list items     | showDeleted          | true          |
| Include an associate list item | includeAssociate     | true          |
| Only show user defined lists   | onlyUserDefinedLists | false         |

## Sample Request

```http! theme={null}
GET /api/v1/MDOList/lists
Authorization: Basic dGplMDpUamUw
Accept: application/json; charset=utf-8
Accept-Language: *

```

## Sample Code

```cs theme={null}
var listProvider = ClassFactory.CreateRequired<SuperOffice.CRM.Lists.ISoListProviderFactory>().Create("lists", forceFlatList: true);
foreach (var item in listProvider.RootItems) {
    Console.WriteLine("{0} {1} {2} {3}", 
         item.Id, ResourceManager.ParseInlineResources(item.Name), item.StyleHint, item.ExtraInfo);
}
```

## Sample Output

| Id  | Name                      | StyleHint | ExtraInfo |
| --- | ------------------------- | --------- | --------- |
| 148 | Chat Protocols            |           |           |
| 163 | Subscription - Type       |           |           |
| 164 | Privacy - Source          |           |           |
| 165 | Privacy - Legal basis     |           |           |
| 166 | Company - Category family |           |           |
| 176 | Task menuAufgabe“"        |           |           |
| 178 | Mailing domains           |           |           |
| 97  | Document - Template       |           |           |
| 98  | General - Resource        |           |           |
| 152 | Company - Category        |           |           |
| 153 | Company - Business        |           |           |
| 101 | General - User group      |           |           |
| 102 | General - Relation        |           |           |
| 103 | Follow-up - Type          |           |           |
| 104 | Follow-up - Priority      |           |           |
| 154 | Company - Interest        |           |           |
| 155 | Contact - Interest        |           |           |
| 156 | Contact - Position        |           |           |
| 157 | Contact - Mr/Mrs          |           |           |
| 109 | Project - Type, Stages    |           |           |
| 110 | Project - Status          |           |           |

## Related MDO Lists

* "listsheadings"
* "listsheadingswithallitem"
* "listsheadingswithallitemwithnoselection"
* "listsheadingswithnoselection"
* "listswithallitem"
* "listswithallitemwithnoselection"
* "listswithnoselection"


## Related topics

- [Lists](/en/admin/lists/index.md)
- [Get List Of Lists](/en/api/reference/restful/rest/list_mdo/get-list-of-lists.md)
- [List events](/en/automation/webhook/reference/list-events.md)
- [Specialized lists](/en/admin/lists/specialized-lists.md)