Commands › Parcels
parcel_info
Details of a parcel in the bot's region
Usage
curl -X POST "https://api.lifebots.cloud/api/bot.html" \
-H "Content-Type: application/json" \
-d '{
"action": "parcel_info",
"apikey": "YOUR_API_KEY",
"botname": "Joe Resident",
"secret": "bot-secret-123",
"dataType": "json"
}' Every request also needs apikey, botname and secret — see Authentication.
Parameters
| Name | Required | Description |
|---|---|---|
xnumber | no | X coordinate. Default: where the bot stands. |
ynumber | no | Y coordinate. |
getvaluestring | no | Return only one field, named without the parcel_ prefix (e.g. name). |
Returns
| Field | Type | Description |
|---|---|---|
parcel_* | mixed | About 50 fields: name, owner, group, area, prim counts, media and music URLs, sale price, landing point, flags, traffic and more. |
Example response
{
"result": "OK",
"parcel_name": "Welcome Area",
"parcel_description": "",
"parcel_owner": "a2e76fcd-9360-4f6d-a924-000000000000",
"parcel_group": "00000000-0000-0000-0000-000000000000",
"parcel_area": 4096,
"parcel_maxprims": 937,
"parcel_totalprims": 412,
"parcel_musicurl": "",
"parcel_landingpoint": "128/128/25",
"parcel_flags": "1610612736"
} With dataType=json. A failure has result: "FAIL" and the reason in resulttext — see Responses & errors.
Good to know
- Bot's current region only.
- Known issue: for a parcel the bot has not looked at yet, the answer can describe a different parcel. Teleport or walk the bot there first for reliable results.