PBN.LTD API docs
View as Markdown

PBN.LTD API

The PBN.LTD API lets you run your hosting account from your own dashboards, scripts and AI tools: list and search sites, create sites of every type, change settings and PHP versions, manage DNS records, take and restore backups, browse and upload files, read error and access logs, check health, see billing and invoices, and open support tickets.

What it covers

343 endpoints in 47 areas. Every one of them is also a tool on the MCP server, so an AI assistant can do the same things by being asked in plain words. Anything that costs money answers with a checkout link for you to open and pay - the API never charges you by itself.

Base URL: https://app.pbn.ltd/api/v1. Every answer is JSON (except file and PDF downloads), UTF-8, with dates in ISO 8601 UTC.

Quick start

  1. Create a key at API keys (menu: your name > API keys). Copy it - it is shown once.
  2. Keep it secret: store it in an environment variable, e.g. export PBN_API_KEY=pbn_....
  3. Call the API:
curl -s https://app.pbn.ltd/api/v1/me -H "Authorization: Bearer $PBN_API_KEY"
import os, requests
r = requests.get("https://app.pbn.ltd/api/v1/sites", headers={"Authorization": "Bearer " + os.environ["PBN_API_KEY"]})
for site in r.json()["data"]:
    print(site["domain"], site["state"], site["online"]["status"] if site["online"] else "-")
const res = await fetch("https://app.pbn.ltd/api/v1/sites?state=frozen", {
  headers: {Authorization: `Bearer ${process.env.PBN_API_KEY}`}
});
const {data} = await res.json();

What you get back

A single object comes as {"data": {...}}; a list as {"data": [...], "next_cursor": "...", "has_more": true} (see Pagination). An action that finishes later also returns a job (see Jobs). An error is {"error": {"code": "...", "message": "...", "details": {...}}} with a matching HTTP status (see Errors).

Same rules as the panel

The API does exactly what the panel does, through the same code: the same checks, limits and refusals apply (an expired plan, a paused or suspended site, a busy site, the site-slot limit, the ticket limits, add-ons that must be active). The API never gives more access than your account has.

Machine-readable

Try it

Paste an API key and call GET /me from this page. The key goes straight to the API from your browser and is not stored.