API Reference

Leases visible to this key, soonest to expire first

Enabled per organisation

This endpoint answers 403 until our staff enable the Firewall API flag on your organisation, and its ability cannot be granted to a key before then. Open a ticket saying what you intend to build — see Activation.
GET
/leases

Paginated like /rules: limit (default 100, at most 1000), offset, and meta.total / meta.next_offset.

Authorization

BearerAuth firewall.read
AuthorizationBearer <token>

Your organisation API key: Authorization: Bearer tbk_...

In: header

Scope: firewall.read

Query Parameters

limit?integer

page size, at most 1000

Range1 <= value <= 1000
Default100
offset?|

items to skip; the next page is offset + limit while next_offset is set

Range0 <= value
Default0

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/leases"
{  "data": [    {      "ref": "string",      "tenant": "string",      "ttl": 0,      "expires_at": "string",      "created_at": "string",      "rule": {        "kind": "ip",        "destination": {          "ip": "207.174.40.5",          "port": 27015        },        "source": {          "ip": "0.0.0.0",          "port": 0        },        "protocol": "any",        "action": "deny",        "ref": "string",        "id": 0,        "expires_at": "string"      }    }  ],  "meta": {    "total": 0,    "limit": 0,    "offset": 0,    "next_offset": 0  }}