> ## Documentation Index
> Fetch the complete documentation index at: https://superofficeas-bugfix-ty-screen-designer-paradox.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# How to get all lists

> How to get all lists via web service APIs

To get all available lists, use the `Lists` keyword.

<Tabs>
  <Tab title="RESTful REST API">
    ```http theme={null}
    GET https://{{env}}.superoffice.com/{{tenant}}/api/v1/List
    Authorization: Bearer {{token}}
    Accept: application/json; charset=utf-8
    ```
  </Tab>

  <Tab title="HTTP RPC Agent API">
    Ironically, it's not possible to get all lists from the List endpoint. Use the MDO endpoint to get all built-in and user-defined lists.

    This has some limitations in that the results do not specify if the list uses Groups and Headings. For that, use the RESTful REST List endpoint.

    ```http theme={null}
    POST https://{{env}}.superoffice.com/{{tenant}}/api/v1/Agents/MDO/GetList HTTP/1.1
    Authorization: Bearer {{token}}
    Accept: application/json; charset=utf-8
    Content-Type: application/json; charset=utf-8

    {
      "Name": "Lists",
      "ForceFlatList": false,
      "AdditionalInfo": "",
      "OnlyHistory": false
    }
    ```
  </Tab>

  <Tab title="WebApi Proxy API">
    Ironically, it's not possible to get all lists from the ListAgent. Use the MDO endpoint to get all built-in and user-defined lists.

    This has some limitations in that the results do not specify if the list uses Groups and Headings. For that, use the RESTful REST List endpoint.

    ```csharp theme={null}
    var config = new WebApiOptions(tenant.WebApiUrl);
    config.Authorization = new AuthorizationAccessToken("8A:Cust12345.Example-Token", OnlineEnvironment.SOD);
    var mdoAgent = new MDOAgent(config);

    var allLists = mdoAgent.GetSimpleListAsync("lists").Result;
    ```
  </Tab>
</Tabs>

[Back](./index)