# Lists

Use lists to create and maintain sets of values that may be referenced in rule conditions.
Commonly used lists contain values related to conditions that target specific properties such as: customers, transactions, or BINs.

You may grant list edit permissions to members of your team without enabling them to edit rules.
This may be useful if your workflow involves frequent updates to value sets that are used in rule or bind conditions.
List order may not be maintained and duplicates may be removed.

For more information, see [Value lists](https://www.rebilly.com/docs/automations/create-a-value-list/#value-lists).

## Retrieve lists

 - [GET /lists](https://www.rebilly.com/static/_spec/catalog/all-3.0/lists/getlistcollection.md): Retrieves a collection of lists.
This operation returns the most recent version of each list.

## Create a list

 - [POST /lists](https://www.rebilly.com/static/_spec/catalog/all-3.0/lists/postlist.md): Creates a new list.

## Retrieve latest list version

 - [GET /lists/{id}](https://www.rebilly.com/static/_spec/catalog/all-3.0/lists/getlist.md): Retrieves the latest version of a list with a specified ID.

## Upsert a list

 - [PUT /lists/{id}](https://www.rebilly.com/static/_spec/catalog/all-3.0/lists/putlist.md): Creates or updates (upserts) a list with a specified ID.

## Delete a list

 - [DELETE /lists/{id}](https://www.rebilly.com/static/_spec/catalog/all-3.0/lists/deletelist.md): Deletes a list with a specified ID.

## Retrieve specific list version

 - [GET /lists/{id}/{version}](https://www.rebilly.com/static/_spec/catalog/all-3.0/lists/getlistversion.md): Retrieves a specified version of a list with a specified ID.