Getting Started
What is the MANRS Observatory?
The MANRS Observatory tracks routing security hygiene for Autonomous Systems (ASes) across the internet. It ingests BGP archives, RPKI repositories, IRR databases, incident feeds, and other sources, then computes daily MANRS conformance scores for each ASN. Results are accessible via a REST API and an interactive web dashboard.
Data Collected
- BGP / RIS: Route announcements from RIPE RIS peers
- RPKI: Route Origin Authorizations from all five RIRs
- IRR: Route objects from AFRINIC, APNIC, RADB, RIPE, and others
- GRIP: BGP hijacking and route leak incidents
- Bogons: M3/M4 bogon prefix/ASN announcements
- Spoofer: IP spoofing measurement events (CAIDA SPOOFER)
- WHOIS / PeeringDB: Contact validity per ASN across all RIRs
- ROV: Route Origin Validation filter rates by country/ASN
- NRO: Numeric resource allocations and assignments
MANRS Conformance Scoring
Each ASN is scored monthly across the following metrics:
| Metric | Description |
|---|---|
| M1 | Route leaks (detection not yet sourced) |
| M2 | Route misoriginations / hijacks (GRIP) |
| M3 / M4 | Bogon prefix / bogon ASN announcements |
| M5 | Anti-spoofing (CAIDA Spoofer) |
| M7IRR / M7RPKI | Announced routes registered in IRR / valid ROAs |
| M8 | Contact information (Coordination) |
| M9 | RPKI deployment |
See Conformance Scores for how these roll up into category scores.
Using the API
The REST API is available at /api/v2/. Interactive documentation is served at /api/v2/docs.
Authentication
All endpoints that require authentication accept an API key via the Authorization header:
Authorization: Bearer <your-api-key>
API keys can be generated from the Observatory web interface.
Key Endpoints
GET /api/v2/ases/{asn} AS identity and metadata
GET /api/v2/scores Category + per-action scores + incident counts, filterable by asns, economies, region, participantIDs
GET /api/v2/scores/details?asn= Full per-ASN detail: scores, incidents, routing metrics, trend, 6-month history
GET /api/v2/scores/summary Aggregate readiness key figures + statistics, scoped by region/economy/asns
GET /api/v2/participants MANRS participant directory
GET /api/v2/scores/conformance Per-participant declared + measured conformance (all programmes, or filter by type)
GET /api/v2/roas Route Origin Authorizations