Bots · Developer account
getBot
Get a bot's details
This method authenticates with your developer account. The easiest way to call it is the dashboard, which signs the request for you. Direct calls need a dashboard session cookie.
Returns one bot (owner-scoped; non-owners and deleted bots get 404) plus its webhook rows and group memberships.
Request
curl https://api.sprintelex.com/getBot \
# authenticated with your dashboard session \
-H "Content-Type: application/json" \
-d '{"bot_id":"<bot-id>"}'Parameters
| Name | Type | Required | Rules |
|---|---|---|---|
| bot_id | string | Yes | - |
Response
{ ok: true, result: { bot: { id, name, username, avatar_url, description, created_at, is_suspended, suspended_at, suspension_reason }, webhooks: [ { env, url, is_disabled, last_error, last_error_at, pending_count, updated_at } ], groups: [ { group_id, privacy_mode, added_at } ] } }Rate limit: none in code
Errors
| Status | Error | When |
|---|---|---|
| 400 | bot_id is required | missing bot_id |
| 404 | bot not found | no such bot, not owned by caller, or deleted |