Voidly
Interactive playground

Explore the API.

Explore the endpoint catalog. Try a read request and inspect its status and JSON.

  1. Endpoint catalog
  2. Browser request
  3. Response + schema

Public read requests. Licensing follows each source. API host: api.voidly.ai.Full reference →

Atlas

  • GET/v1/atlas/score
    Try it

    A-F country grades — composite censorship score. Lightweight leaderboard variant.

    Example, response fields & cURL
    Example
    https://api.voidly.ai/v1/atlas/score?limit=20
    Response shape
    • count: number
    • results[]: { country, country_name, score, grade }
    • methodology: string
    Curl
    curl 'https://api.voidly.ai/v1/atlas/score?limit=20'
  • GET/v1/atlas/score-v2
    Try it

    Level-aware composite (50% structural baseline + change). Fixes v1 chronic-blocker under-scoring.

    Example, response fields & cURL
    Example
    https://api.voidly.ai/v1/atlas/score-v2?limit=20
    Response shape
    • count: number
    • results[]: { country, country_name, score, grade, components, confidence }
    Curl
    curl 'https://api.voidly.ai/v1/atlas/score-v2?limit=20'
  • GET/v1/atlas/score-v2/{cc}
    Try it

    Atlas Score v2 for one country with full component breakdown.

    Example, response fields & cURL
    Example
    https://api.voidly.ai/v1/atlas/score-v2/IR
    Response shape
    • country: string
    • score: number
    • grade: string
    • components: object
    Curl
    curl 'https://api.voidly.ai/v1/atlas/score-v2/IR'
  • GET/v1/atlas/compare
    Try it

    Side-by-side comparison row for an arbitrary set of countries.

    Example, response fields & cURL
    Example
    https://api.voidly.ai/v1/atlas/compare?countries=IR,RU,CN
    Response shape
    • rows[]: { country, country_name, score, grade, incidents_30d, evidence_30d }
    Curl
    curl 'https://api.voidly.ai/v1/atlas/compare?countries=IR,RU,CN'
  • GET/v1/atlas/changelog
    Try it

    ML model registry — every train + promote event auto-stitched from sidecar JSONs.

    Example, response fields & cURL
    Example
    https://api.voidly.ai/v1/atlas/changelog
    Response shape
    • entries[]: { model_name, version, trained_at, loco_f1, loco_auc, top_features }
    Curl
    curl 'https://api.voidly.ai/v1/atlas/changelog'
  • GET/v1/atlas/cite
    Try it

    BibTeX / RIS / markdown citation for an incident or dataset snapshot.

    Example, response fields & cURL
    Example
    https://api.voidly.ai/v1/atlas/cite?id=IR-2026-0142
    Response shape
    • bibtex: string
    • ris: string
    • markdown: string
    Curl
    curl 'https://api.voidly.ai/v1/atlas/cite?id=IR-2026-0142'

Classifier

  • GET/v1/classifier/info
    Try it

    Live classifier transparency — version, training data, stratified F1, LOCO splits.

    Example, response fields & cURL
    Example
    https://api.voidly.ai/v1/classifier/info
    Response shape
    • version: string
    • stratified_f1, loco_f1_mean, loco_f1_median
    • training_samples: number
    Curl
    curl 'https://api.voidly.ai/v1/classifier/info'
  • GET/v1/classifier/feature-importance
    Try it

    Per-feature gain importance for the live country-day classifier (v3.3).

    Example, response fields & cURL
    Example
    https://api.voidly.ai/v1/classifier/feature-importance
    Response shape
    • features[]: { name, importance, rank }
    Curl
    curl 'https://api.voidly.ai/v1/classifier/feature-importance'
  • GET/v1/classifier/score/{cc}
    Try it

    Live classifier score for one country today.

    Example, response fields & cURL
    Example
    https://api.voidly.ai/v1/classifier/score/IR
    Response shape
    • country, prediction (0/1), probability, top_features
    Curl
    curl 'https://api.voidly.ai/v1/classifier/score/IR'

Forecast

  • GET/v1/forecast/{cc}/7day
    Try it

    7-day shutdown-risk estimates and reported drivers. Interval and ACI fields may be withheld pending validation.

    Example, response fields & cURL
    Example
    https://api.voidly.ai/v1/forecast/IR/7day
    Response shape
    • forecast[]: { day, date, risk, drivers }
    • interval and ACI fields: optional; inspect current response
    Curl
    curl 'https://api.voidly.ai/v1/forecast/IR/7day'
  • GET/v1/forecast/{cc}/multi-horizon
    Try it

    1d / 7d / 30d horizons with per-horizon SHAP + monotonicity consistency check.

    Example, response fields & cURL
    Example
    https://api.voidly.ai/v1/forecast/IR/multi-horizon
    Response shape
    • horizons[]: { horizon_days, risk, interval_90, top_features }
    • consistency: { monotonic }
    Curl
    curl 'https://api.voidly.ai/v1/forecast/IR/multi-horizon'
  • GET/v1/forecast/multi-horizon/info
    Try it

    Multi-horizon model metadata — LOCO AUC per horizon, training samples, calibration.

    Example, response fields & cURL
    Example
    https://api.voidly.ai/v1/forecast/multi-horizon/info
    Response shape
    • horizons: { "1d", "7d", "30d" }
    • loco_auc, brier, calibration_slope
    Curl
    curl 'https://api.voidly.ai/v1/forecast/multi-horizon/info'
  • GET/v1/forecast/asn-gnn/{asn}
    Try it

    GraphSAGE-2 GNN risk score over CAIDA AS-AS peering topology (May 2026 serial-2).

    Example, response fields & cURL
    Example
    https://api.voidly.ai/v1/forecast/asn-gnn/AS47541
    Response shape
    • asn, risk_score, honest_caveats[]
    • k-hop neighbors
    Curl
    curl 'https://api.voidly.ai/v1/forecast/asn-gnn/AS47541'

Anomaly

  • GET/v1/anomaly/dbscan/{cc}
    Try it

    CenDTect-style DBSCAN per-country rolling 45-day anomaly. Second-opinion signal.

    Example, response fields & cURL
    Example
    https://api.voidly.ai/v1/anomaly/dbscan/IR
    Response shape
    • anomalies[]: { date, score, dbscan_label, features }
    • auc_vs_labels
    Curl
    curl 'https://api.voidly.ai/v1/anomaly/dbscan/IR'
  • GET/v1/anomaly/dbscan/leaderboard
    Try it

    Countries ranked by most-recent DBSCAN anomaly score.

    Example, response fields & cURL
    Example
    https://api.voidly.ai/v1/anomaly/dbscan/leaderboard
    Response shape
    • leaderboard[]: { country, score, last_anomaly_date }
    Curl
    curl 'https://api.voidly.ai/v1/anomaly/dbscan/leaderboard'
  • GET/v1/anomaly/domain-drift/leaderboard
    Try it

    Per-domain HDBSCAN drift — week-over-week novel blocking patterns.

    Example, response fields & cURL
    Example
    https://api.voidly.ai/v1/anomaly/domain-drift/leaderboard
    Response shape
    • leaderboard[]: { domain, drift_score, novel_methods }
    Curl
    curl 'https://api.voidly.ai/v1/anomaly/domain-drift/leaderboard'

Sentinel

  • GET/v1/sentinel/accuracy
    Try it

    Sentinel empirical accuracy is held pending a qualified forecast and outcome archive; inspect current response status.

    Example, response fields & cURL
    Example
    https://api.voidly.ai/v1/sentinel/accuracy
    Response shape
    • metrics_validated and status
    • prod_rolling only after qualified validation
    Curl
    curl 'https://api.voidly.ai/v1/sentinel/accuracy'
  • GET/v1/sentinel/calibration
    Try it

    Calibration status; empirical interval coverage is held pending qualified validation.

    Example, response fields & cURL
    Example
    https://api.voidly.ai/v1/sentinel/calibration
    Response shape
    • status and validation caveat
    • series only after qualified validation
    Curl
    curl 'https://api.voidly.ai/v1/sentinel/calibration'
  • GET/v1/sentinel/current_risk/{cc}
    Try it

    Current-day country risk with source context; interval bounds may be withheld.

    Example, response fields & cURL
    Example
    https://api.voidly.ai/v1/sentinel/current_risk/IR
    Response shape
    • risk, top_features, similar_incidents[]
    • interval_90: optional; do not infer coverage
    Curl
    curl 'https://api.voidly.ai/v1/sentinel/current_risk/IR'
  • GET/v1/sentinel/global_heatmap
    Try it

    Single-call global risk heatmap — every watched country sorted by risk.

    Example, response fields & cURL
    Example
    https://api.voidly.ai/v1/sentinel/global_heatmap?min_risk=0
    Response shape
    • countries[]: { country, risk }
    • interval_90: optional; do not infer coverage
    Curl
    curl 'https://api.voidly.ai/v1/sentinel/global_heatmap?min_risk=0'
  • GET/v1/sentinel/movers
    Try it

    Biggest forecast deltas vs N days ago — find rising-risk countries.

    Example, response fields & cURL
    Example
    https://api.voidly.ai/v1/sentinel/movers?days=7&limit=20
    Response shape
    • movers[]: { country, delta, risk_now, risk_then }
    Curl
    curl 'https://api.voidly.ai/v1/sentinel/movers?days=7&limit=20'
  • GET/v1/sentinel/stealth-blackouts
    Try it

    Stealth-blackout detector (Aryapour 2025 pattern) — partial-outage signature flags.

    Example, response fields & cURL
    Example
    https://api.voidly.ai/v1/sentinel/stealth-blackouts
    Response shape
    • detections[]: { country, date, signature_score }
    Curl
    curl 'https://api.voidly.ai/v1/sentinel/stealth-blackouts'

Data

  • GET/data/incidents
    Try it

    List citable incidents. Filter by country, severity, sources, time.

    Example, response fields & cURL
    Example
    https://api.voidly.ai/data/incidents?country=IR&limit=10
    Response shape
    • incidents[]: { id, readableId, country, title, severity, sources, evidenceCount }
    Curl
    curl 'https://api.voidly.ai/data/incidents?country=IR&limit=10'
  • GET/data/incidents/{id}
    Try it

    Single citable incident with evidence permalinks. Accepts hash ID or readable ID.

    Example, response fields & cURL
    Example
    https://api.voidly.ai/data/incidents/IR-2026-0142
    Response shape
    • id, readableId, country, title, severity, evidence[]
    Curl
    curl 'https://api.voidly.ai/data/incidents/IR-2026-0142'
  • GET/data/incidents/stats
    Try it

    Headline corpus stats — totals, by_severity, by_type, top_countries, growth.

    Example, response fields & cURL
    Example
    https://api.voidly.ai/data/incidents/stats
    Response shape
    • total, total_evidence, by_severity, by_type, top_countries, growth
    Curl
    curl 'https://api.voidly.ai/data/incidents/stats'
  • GET/data/incidents/export
    Try it

    Bulk export incidents in CSV / JSONL / JSON for offline analysis.

    Example, response fields & cURL
    Example
    https://api.voidly.ai/data/incidents/export?format=csv&country=IR
    Response shape
    • (streamed file — content type depends on ?format=)
    Curl
    curl 'https://api.voidly.ai/data/incidents/export?format=csv&country=IR'
  • GET/data/incidents/feed.rss
    Try it

    RSS feed of recent incidents — drop into any reader for live updates.

    Example, response fields & cURL
    Example
    https://api.voidly.ai/data/incidents/feed.rss
    Response shape
    • (XML — RSS 2.0)
    Curl
    curl 'https://api.voidly.ai/data/incidents/feed.rss'

Probe

  • GET/v1/probe/stats
    Try it

    Aggregate Voidly probe statistics. The response states its own field scope.

    Example, response fields & cURL
    Example
    https://api.voidly.ai/v1/probe/stats
    Response shape
    • active_nodes, total_probes, domains_tested, countries_covered
    Curl
    curl 'https://api.voidly.ai/v1/probe/stats'

ISP

  • GET/v1/isp/index
    Try it

    ISPs ranked by composite censorship score within one country.

    Example, response fields & cURL
    Example
    https://api.voidly.ai/v1/isp/index?country=IR
    Response shape
    • isps[]: { asn, name, score, methods, evidence_count }
    Curl
    curl 'https://api.voidly.ai/v1/isp/index?country=IR'
  • GET/v1/isp/worst
    Try it

    Global worst ISPs ranked across all countries.

    Example, response fields & cURL
    Example
    https://api.voidly.ai/v1/isp/worst?limit=20
    Response shape
    • isps[]: { asn, name, country, score }
    Curl
    curl 'https://api.voidly.ai/v1/isp/worst?limit=20'

More

  • Auth-gated endpoints (alerts, agent send, write actions) live in the full reference.
  • Want a Postman-shaped collection? See /api-docs for the OpenAPI export.
  • All responses are CC BY 4.0. Cite as Voidly Atlas, accessed 2026-11-18.
About this view

Browse the endpoint catalog. Click Try it on a card to fetch its read response in your browser. The cURL example is separate from the returned JSON; endpoint status and errors appear above the catalog.