# key2name

:::tip
Avoid using key2name in a loop, instead [check out the new `keys2names`](/doc/keys2names-Y264PtrhA5) action!

:::

Returns an avatar’s Second Life name by their UUID. This command works in opposition to [`name2key`](/doc/name2key-Xx5elYSLu3).

```csharp
// See "LSL Helper Functions" page for this function
smartbotsAPI("key2name", [
  "key", "76e96174-ddcf-482f-86aa-c9394664082f",
  "request_case", 1
]);
```

# Variables

The following table shows input values (you send them with the API call) and returned output values.


:::info
This API command applies only for **Standard bots**.

:::

## Input basic parameters

| Variable | Required | Description |
|----------|----------|-------------|
| action   | yes      | = key2name  |
| apikey   | yes      | Your personal [developer's API key](/doc/developers-api-key-tw8bQj4LSJ) |
| botname  | yes      | Your bot's SL login |
| secret   | yes      | [Bot access code](https://www.mysmartbots.com/docs/Bot_access_code) of your bot |
| dataType | optional | Set to `"json"` to get JSON reply instead of URL-encoded string |
| custom   | optional | The custom data (string) to be passed back to caller script. This value will be returned back to the caller in HTTP response |

## Input

| Variable | Required | Description |
|----------|----------|-------------|
| key      | yes      | The UUID of the avatar |
| request_case | optional | Set to `1` to get the avatar’s name in the exact case as it appears in Second Life (otherwise it may be lowercase) |

## Output

*(To be received in* `*http_response*` *LSL event, see* [*docs for details*](/doc/doing-http-api-calls-c6FSEMF7bP)*)*

| Variable | Description |
|----------|-------------|
| result   | OK - command completed successfully<br>FAIL - command failed |
| resulttext | Detailed reason for the failure |
| custom   | The value from input "custom" parameter |
| key      | The UUID you sent |
| name     | The avatar’s Second Life name |

# Return value

The command returns the Second Life name associated with the specified UUID.  
Use [`name2key`](/doc/name2key-Xx5elYSLu3) to perform the reverse lookup (get a UUID from a name).

# Example

**Requesting the avatar’s Second Life name by UUID:**

```
https://www.mysmartbots.com/api/bot.html?action=key2name&key=76e96174-ddcf-482f-86aa-c9394664082f&...
```

**Result:**

```
name = BarKeeeper Resident
key = 76e96174-ddcf-482f-86aa-c9394664082f
```