# avatar_picks

Returns a list of a resident’s **profile picks**.

```csharp
// See "LSL Helper Functions" page for this function
smartbotsAPI("avatar_picks", [
  "avatar", "cd93067e-7c4e-41c0-ba91-be01f4bafe35"
]);
```

```snippet http-api-variables-OmJyUigTgO
```


:::info
**Note:** This API command applies only to **Standard bots**.

:::

```snippet http-api-input-basic-parameters-5FcVlaJbq0 action="avatar_picks"
```

```snippet http-api-input-q5yvAagqsZ
avatar     | yes      | The UUID of the avatar whose picks to fetch
skipnames  | optional | Skip picks whose name **contains** this substring (case-insensitive)
matchnames | optional | Return only picks whose name **contains** this substring (case-insensitive)
matchuuid  | optional | Return only the pick for this **parcel UUID**
```

```snippet http-api-output-JAwUcmg7i7
total | Total number of picks (not affected by filters)
picks | List of the resident’s picks (possibly filtered) — a string containing parcel UUIDs and pick names separated by newlines
```

### Example Output Format

```
Parcel-UUID-1 name-of-the-pick-1
Parcel-UUID-2 name-of-the-pick-2
...
```

## Working with large lists

The **LSL** `**llHTTPRequest()**` function limits response size to **2048 bytes (1024 Unicode characters)**.  
If the resident has many picks, you can filter results using these parameters:

* `skipnames` — ignore picks containing this substring
* `matchnames` — include only picks containing this substring
* `matchuuid` — return a specific pick by parcel UUID

## Examples

### Example 1 — Get all picks

```
https://www.mysmartbots.com/api/bot.html?action=avatar_picks&avatar=cd93067e-7c4e-41c0-ba91-be01f4bafe35&...
```

**Response:**

```
07300856-2d89-754e-dfb2-dd73553d76dc Earn2Life.com Discount Shop
ff1dd581-7eea-8b1f-68f5-eab19046571d Earn2Life.com: Free Lindens & Jobs!
9e1c606a-c69c-5af0-cc35-017854b8ec12 SLBiz2Life Advertising: advertise here!
```

### Example 2 — Filter by name (“earn2life”)

```
https://www.mysmartbots.com/api/bot.html?action=avatar_picks&avatar=cd93067e-7c4e-41c0-ba91-be01f4bafe35&matchnames=earn2life&...
```

**Response:**

```
07300856-2d89-754e-dfb2-dd73553d76dc Earn2Life.com Discount Shop
ff1dd581-7eea-8b1f-68f5-eab19046571d Earn2Life.com: Free Lindens & Jobs!
```