Browse the API reference

API v1

Chaos Monitor API

Every host this monitor discovers is available over a token-authenticated REST API. Each endpoint page ships with a runnable console and copy-paste samples in five languages.

Endpoints

23

Rate limit

Unlimited

Auth

Bearer token

Three steps to your first response

Create a key on the account page, send it as Authorization: Bearer …, then open any endpoint below and press Send request.

All endpoints

Getting started

GET/API index GET/meCurrent token GET/openapi.jsonOpenAPI 3.1 spec

Domains

GET/domainsList tracked domains GET/domains/{domain}Get one domain GET/domains/{domain}/subdomainsList a domain's hosts GET/domains/{domain}/subdomains/newNew hosts for a domain

Subdomains

GET/subdomains/newNew hosts across everything GET/subdomains/searchSearch all hosts

Platforms

GET/platformsList platforms GET/platforms/{slug}Get one platform GET/platforms/{slug}/domainsPlatform domains GET/platforms/{slug}/subdomainsAll platform subdomains GET/platforms/{slug}/subdomains/newPlatform new hosts

Scans

GET/scansScan history GET/scans/statusWorker status GET/scans/{id}Get one scan POST/scansQueue a scan POST/scans/rescan-allFull re-scan

Stats

GET/statsGlobal stats GET/stats/timeseriesDiscovery time-series GET/stats/top-domainsTop domains by new hosts

Export

GET/exportBulk export

Quickstart

First request

curl "https://chaos.thescope.top/api/v1/subdomains/new?hours=24&limit=50" \
  -H "Authorization: Bearer chs_live_xxxxxxxxxxxx"

Base URL

https://chaos.thescope.top/api/v1

OpenAPI 3.1 Get a token