Turn ON or OFF ads

POST

https://api.bots.business/v2/user/iterations/toggle_ads

Last modified:2025-11-01 13:19:19

Use this endpoint to enable or disable advertisements in your bot. When ads are enabled, you receive increased iteration limits and potential earnings, but advertisements will be displayed to your bot's users.

Request

Query Params

Responses

🟢200Success

application/json

Body

🟠401Unauthorized

🟠404Not Found

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.bots.business/v2/user/iterations/toggle_ads?api_key=UKDZu-c68cubrIbniuE2P_nWj0p5r4IHARNrAV-I'

Response Example

200 - Success

{
    "id": 238460,
    "limit": 7500,
    "progress": 477,
    "quotum_type_id": 1,
    "user_id": 22425807,
    "started_at": "2025-10-23T13:48:40.419Z",
    "created_at": "2023-11-30T04:02:45.971Z",
    "updated_at": "2025-10-28T04:47:12.877Z",
    "extra_points": 46,
    "ended_at": "2025-11-23T13:48:40.419Z",
    "paid_cycles_count": 0,
    "have_ads": false,
    "quotum_type": {
        "id": 1,
        "name": "IterationQuota",
        "base_limit": 7500,
        "payment_plan_id": 1,
        "created_at": "2018-12-17T04:44:36.388Z",
        "updated_at": "2025-04-08T14:16:12.369Z",
        "ads_limit": 3000000
    }
}

Modified at 2025-11-01 13:19:19

Get iteration usage

Get payment plan