API Endpoints¶
The HTTP service supports GET requests on the following paths:
/api/v1/status
Returns exhaustive information in JSON format on all trust anchors, repositories, RRDP and rsync connections, as well as RTR and HTTP sessions. This data set provides the source for the Routinator user interface.
/api/v1/validity/as-number/prefix
Returns a JSON object describing whether the route announcement given by its origin AS Number and address prefix is RPKI valid, invalid, or not found. A complete list of VRPs that caused the result is included.
/validity?asn=as-number&prefix=prefix
Same as above but with a more form-friendly calling convention.
/json-delta, /json-delta?session=session?serial=serial
Returns a JSON object with the changes since the dataset version identified by the session and serial query parameters. If a delta cannot be produced from that version, the full data set is returned and the member reset in the object will be set to true. In either case, the members session and serial identify the version of the data set returned and their values should be passed as the query parameters in a future request.
The members announced and withdrawn contain arrays with route origins that have been announced and withdrawn, respectively, since the provided session and serial. If reset is true, the withdrawn member is not present.
In addition, the /log
endpoint returns logging
information and the /metrics
, /status
and
/version
endpoints provide monitoring data.
New in version 0.9.0: The /json-delta
path
Changed in version 0.9.0: The /api/v1/status
path