API Reference › Bots — Objects & Nearby
Find Objects
GET
/bots/{bot_id}/objectsSearch objects in the bot's region.
Usage
curl "https://api.lifebots.cloud/api/v1/bots/$BOT_ID/objects?distance=20" \
-H "Authorization: Bearer $ACCESS_TOKEN"Path parameters
| Name | Type | Description |
|---|---|---|
bot_id | UUID | The bot's avatar UUID (agentId from GET /bots). |
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
name | string | no | Name contains this text. |
uuid | UUID | no | A specific object. |
distance | number | no | Search radius in metres. |
owner | UUID | no | Only objects owned by this avatar. |
Example response
{
"success": true,
"data": {
"result": "OK"
},
"meta": {
"timestamp": "2026-10-02T12:00:00.000Z",
"version": "1.0"
}
} Always check success; for commands the bot carries out, also check data.result. See Responses & errors.