Documentation

Developer Documentation


The Routing Assets Database (RADb) can be live queried via the whois service, the Near Real Time Mirroring (NRTM) service, an API, FTP, and the radb.net website. To guide further development, we'd love to hear about how you are using RADb. Please drop us an email to tell us about a tool or service the makes use of RADb data: radb@merit.edu

WHOIS Service

The RADb whois-like service is the authoritative public interface to The Routing Assets Database.

The whois service includes objects sourced in RADb along with objects of each IRR that is mirrored by RADb. Whois is intended primarily for human consumption and low traffic programmatic usage.

Under typical conditions: - the whois service will accept a total of five open connections per source - committed edits are presented within ten minutes, often instantly

Developers are encouraged to: - use an open connection for multiple queries - build consumer operated utilities that source data from whois.radb.net - set identifiable IPv4 and IPv6 PTR records in DNS, when providing a low-traffic service sourcing data from whois.radb.net - build backoff and retry routines when timeouts or failed connections are encountered

Developers are discouraged from: - retrieving bulk updates directly from the whois service - utilizing high-traffic tools in an automated fashion direct from the whois service

Near Real Time Mirroring (NRTM)

The RADb is available by the IRR Near Real Time Mirroring (NRTM) service.

When an application or process requires the use of the IRR/RPSL query language and the IRRd system-generated responses, developers are encouraged to operate a private whois service and mirror the RADb via the NRTM.

Under typical conditions: - the NRTM service is publically available - committed edits are presented within ten minutes, often instantly

Developers are encouraged to: - use the nrtm.radb.net hostname - set identifiable IPv4 and IPv6 PTR records in DNS, when providing a low-traffic service sourcing data from whois.radb.net - check the mirror for updates no more than every 15 minutes

API Service

A REST API is available for current RADb customers and is built to provide query and edits. Documentation is available on the web.

Under typical conditions: - committed edits are presented instantly

FTP

Periodic snapshots of the entire RADb dataset are published on the FTP service: ftp://ftp.radb.net/radb/dbase/radb.db.gz

An update to the serial number file indicates an updated export is available. ftp://ftp.radb.net/radb/dbase/RADB.CURRENTSERIAL

Developers are encouraged first to consult the serial number (RADB.CURRENTSERIAL) to determine if an updated export is available, before downloading the DB file (radb.db.gz).

RADb.net/query

The RADb website publishes a publicly accessible query form on the web at: https://www.radb.net/query. Programmatic access is considered abuse of the service.