# avatar_info

Returns detailed information about a specific avatar.

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

# Variables

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

## Input basic parameters

| Variable | Required | Description |
|----------|----------|-------------|
| action   | yes      | = avatar_info |
| 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 the caller script. This value will be returned in the HTTP response |

## Input

| Variable | Required | Description |
|----------|----------|-------------|
| avatar   | yes      | The UUID of the avatar to fetch information for |

## 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. See above |
| about    | Profile “About” text |
| born     | Avatar’s Second Life birthday (MM/DD/YYYY) |
| identified | `"1"` if avatar has payment info |
| image    | UUID of the profile image |
| first_life_image | UUID of the “First Life” image |
| first_life_text | “First Life” profile text |
| mature   | `"1"` if profile is marked as mature |
| online   | `"1"` if avatar is currently online |
| partner  | UUID of the avatar’s partner (zero UUID if none) |
| publish_web | `"1"` if the profile can be published on the web |
| transacted | `"1"` if payment info has been used |
| url      | Profile’s web URL |

# Limitations

* This API command is **not intended for mass requests**.  
  It takes about **2–3 seconds** per call.
* Sending requests too frequently (**more than one per 3 seconds**) may cause **throttling**.
* Continuous, rapid requests may cause the bot to **relog**.

# Example

Fetch an avatar’s profile information:

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