Skip to main content

Public API v1

Read-only REST access to the same live data the status pages run on: service status, report volumes, outage history, incidents. Included in the Business plan. Keys are managed at account, API keys.

AUTHENTICATION

Every request carries your key as a bearer token. Keys start with dtk_live_ and are shown once at creation; we store only a hash.

Authorization: Bearer dtk_live_...

401 = missing or unknown key. 403 = revoked key or plan without API access. 429 = rate limit hit; retry after the indicated delay.

ENDPOINTS
  • GET/v1/public/services?search={query}

    Service directory search (name, slug).

  • GET/v1/public/services/{slug}/status

    Canonical live status plus report counts (15m / 1h / 24h) and confidence.

  • GET/v1/public/services/{slug}/history?days={n}

    Daily outage history, up to 90 days.

  • GET/v1/public/incidents?since={iso8601}

    Active and recent incidents across the network.

Responses are aggregates only: report counts, states, timestamps. Individual reporter data is never exposed.

EXAMPLE
curl -H "Authorization: Bearer dtk_live_..." \
  "https://dd-dp.downtester.com/v1/public/services/battlefield-6/status"

The base URL above is the API origin serving this deployment.

RATE LIMITS

60 requests per minute per key, counted in a sliding window. Usage updates the key's last-used timestamp, visible on the key management page. Need more? Studio and Enterprise plans carry custom limits; contact us.

The API surface is rolling out with the current release. If key creation still shows the provisioning notice, the endpoints unlock for your account at the same moment. For agent access to the same data, see the MCP server.

Public API - Downtester Docs