Session Rate Limits

View available rate-limit policies and the current policy for an instance. Paid users can select any policy; free users are limited to strict and standard policies.

GET

https://api.wawp.net/v2/session/rate-limit?access_token=YOUR_ACCESS_TOKEN&instance_id=Your_Instance_ID&policy_slug=standard_policy

Authentication Required

Login to swap the placeholders with your real Instance ID and Access Token.

Log In

Test /v2/session/rate-limit endpoint

Supports

GETPATCH

No query parameters required

This endpoint doesn't expect data in the URL.

Free Plan Restrictions

Free accounts can only switch between strict and standard_policy. Attempting to use a paid policy returns a 403 error.

High-Risk Policies

Policies such as 'unlimited' remove safety buffers. Use them only for low-volume, controlled scenarios to avoid bans.

Best practices

Start with the 'strict' policy for new numbers, then gradually relax to 'standard' after warming up.
Re-check the policy after a restart using GET /v2/session/rate-limit.

Session Rate Limits: /v2/session/rate-limit

Use this endpoint to inspect and change the sending policy applied to a WhatsApp session. Policies control message throughput, daily caps, safety intervals, and group/contact discovery limits to reduce the risk of account bans.

Free vs Paid Policies

Free users can only use the free policies returned in free_policies (typically strict and standard_policy).
Paid users (has_active_plan: true) can use any policy in the policies list, including high-throughput and unlimited options.

Each policy includes a limits object with fields such as:

send_message_per_minute
send_message_daily_cap
account_protection_seconds
concurrent_limit
group_req_per_minute / group_daily_cap
check_req_per_minute / check_daily_cap

How to Update the Policy

Call GET /v2/session/rate-limit to see the current policy and available options.
Choose a policy whose available flag is true.
Call PATCH /v2/session/rate-limit with the selected policy_slug.

The policy is saved in both the application database and the engine metadata so it remains active after restarts.

Request Parameters

Configure the parameters required to interact with this endpoint. All query and body arguments are listed below with their details.

URL Parameters

Passed in the URL query string

`string`		The 12-character ID of the instance Example:
`string`		Your API Access Token Example:
`string`	—	The slug of the policy to apply (required for PATCH). Must be available for the user's plan. Example:

Request Samples

Use these ready-to-go code snippets to integrate our API into your project quickly and efficiently. Choose your preferred language and library.

1const baseUrl = "https://api.wawp.net";
2const endpoint = "/v2/session/rate-limit";
3const params = new URLSearchParams({
4  "instance_id": "Your_Instance_ID",
5  "access_token": "YOUR_ACCESS_TOKEN",
6  "policy_slug": "standard_policy"
7}).toString();
8
9
10fetch(`${baseUrl}${endpoint}${params ? '?' + params : ''}`, {
11  method: "GET",
12  headers: { "Content-Type": "application/json" },
13  
14})
15  .then(async (response) => {
16    if (response.ok) {
17      const data = await response.json();
18      console.log("Success:", data);
19      return data;
20    }
21    
22    // Error Handling
23    if (response.status === 400) {
24      console.error("Error 400: Bad Request - Missing parameters or invalid policy");
25    }
26    if (response.status === 401) {
27      console.error("Error 401: Unauthorized - Invalid access token or instance ID");
28    }
29    if (response.status === 403) {
30      console.error("Error 403: Forbidden - Selected policy requires a paid plan");
31    }
32
33    const errorText = await response.text();
34    console.error(`Error ${response.status}: ${errorText}`);
35  })
36  .catch((error) => console.error("Network Error:", error));

Interactive SamplesUTF-8

Ln 36, Col 1javascript

Expected Responses

Explore all possible responses and outcomes from the server. We have documented each status code with data examples to make success and error handling easier.

Success

application/json

string *

boolean *

array *

Example

{
"status": "success",
"current_policy": "standard_policy",
"has_active_plan": false,
"free_policies": {
  "0": "strict",
  "1": "standard_policy"
  },
"policies": {
  "0": {
    "id": 1,
    "name": "Strict",
    "slug": "strict",
    "description": "Conservative limits for fresh or sensitive accounts.",
    "limits": {
      "send_message_per_minute": 8,
      "send_message_daily_cap": 200,
      "account_protection_seconds": 60,
      "concurrent_limit": 1
      },
    "available": true
    }
  }
}

Bad Request - Missing parameters or invalid policy

Unauthorized - Invalid access token or instance ID

Command Palette

Search for a command to run...