# Lists

Lists APIs provided by Fraud Prevention are used to organize recommendations into categories and manage them.


## Servers

Sandbox environment
```
https://api.sbx.transmitsecurity.io/risk/v1
```

Production environment (US)
```
https://api.transmitsecurity.io/risk/v1
```

Production environment (EU)
```
https://api.eu.transmitsecurity.io/risk/v1
```

Production environment (CA)
```
https://api.ca.transmitsecurity.io/risk/v1
```

Production environment (AU)
```
https://api.au.transmitsecurity.io/risk/v1
```

## Security

### risk_access_token

An access token generated by the [token endpoint](/openapi/token.openapi/other/getaccesstoken)

Type: http
Scheme: bearer
Bearer Format: JWT

## Download OpenAPI description

[Lists](https://developer.transmitsecurity.com/_bundle/openapi/risk/list.openapi.yaml)

## Other

### Create list

 - [POST /lists](https://developer.transmitsecurity.com/openapi/risk/list.openapi/other/createlist.md): Creates a new recommendation list.

### Get all lists

 - [GET /lists](https://developer.transmitsecurity.com/openapi/risk/list.openapi/other/getlists.md): Retrieves all lists of the tenant. To return lists that include a specific recommendation, add item_id  to the query.

### Get list

 - [GET /lists/{list_id}](https://developer.transmitsecurity.com/openapi/risk/list.openapi/other/getlist.md): Retrieves a specific list by its ID.

### Update list

 - [PUT /lists/{list_id}](https://developer.transmitsecurity.com/openapi/risk/list.openapi/other/updatelist.md): Updates a specific list. Currently, you can update a list name.

### Delete list

 - [DELETE /lists/{list_id}](https://developer.transmitsecurity.com/openapi/risk/list.openapi/other/removelist.md): Removes a recommendation list by its ID.

### Add to list

 - [POST /lists/{list_id}/items](https://developer.transmitsecurity.com/openapi/risk/list.openapi/other/additems.md): Adds recommendations to the specific list.

### Remove item from list

 - [DELETE /lists/{list_id}/items/{item_id}](https://developer.transmitsecurity.com/openapi/risk/list.openapi/other/removeitem.md): Removes a specific item from the list.