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

# Lists

> See your saved lists and save restaurants to them.

## saved\_lists

Readlists:read

Lists your saved lists, both your own and ones shared with you. To see a list's brands, pass its `list_id` to [`search_brands`](https://docs.onesauce.ai/tools/research#search_brands).

> What lists do I have?

Takes no inputs.

**Returns**

**lists** `object[]`

**properties**

**list\_id** `string`

**name** `string`

**count** `integer`

How many restaurants the list holds.

**is\_default** `boolean`

**can\_add** `boolean`

False for automatic lists and lists synced from your CRM, which can't be added to.

**last\_activity\_at** `datetime`

## add\_to\_list

Writelists:write

Saves restaurants to one of your lists.

> Save the first five to my Austin Q4 list.

**list\_id** `string` *required*

A `list_id` from `saved_lists` whose `can_add` is true.

**entity\_ids** `string[]` *required*

Onesauce IDs to save, from 1 to 50.

**entity\_type** `"brand" | "location"` (default: brand)

Whether the IDs are brands or locations.

**Returns**

**success** `boolean`

**saved** `integer`

How many restaurants were saved.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.