Blocklist

List, add and delete blocked numbers. A call from a blocklisted number is rejected before reaching the PBX; the change takes effect immediately. PBX key (key=K…). Rate limit: 10 requests per minute.

GETBlocklist

GET https://api.buluthat.com/api/blocked_numbers.php?key=K…&limit=50&page=1

{
  "blocked_numbers": [
    { "id": 4274, "number": "05531234567" },
    { "id": 4301, "number": "02120000000" }
  ],
  "pagination": { "page": 1, "total_count": 2, "total_pages": 1, "limit": 50 }
}

POSTAdd to blocklist

POST https://api.buluthat.com/api/blocked_numbers.php
Content-Type: application/json

{ "key": "K…", "number": "05531234567" }

Response 200 OK, the record id in the body (20212). If the same number is added a second time, the existing id is returned.

Errors: 400 number required, 400 number invalid.

GETRemove from blocklist

GET https://api.buluthat.com/api/blocked_numbers_delete.php?key=K…&number=05531234567

The path form is also accepted: /api/blocked_numbers/delete/?key=K…&number=…. Response 200 OK.

Hidden number blocking

Callers who hide their number (blank CallerID, "anonymous", privacy flag) do not enter the list as a number; this block is turned on with the panel > Number Blocking > "Block hidden numbers" switch. Because carriers carry hidden calls in three different ways, all three are checked.