CINXE.COM

<!DOCTYPE html> <html lang="en"> <head> <meta charset="utf-8"> <meta name="viewport" content="width=device-width,initial-scale=1"> <link href="https://fonts.googleapis.com/css2?family=Public+Sans:wght@100..900&display=swap" rel="stylesheet"> <title>RIPEstat docs | RIPEstat Data API | Docs</title> <meta name="generator" content="VuePress 1.9.7"> <link rel="icon" type="image/png" sizes="128x128" href="/docs/icons/favicon-128x128.png"> <link rel="icon" type="image/png" sizes="96x96" href="/docs/icons/favicon-96x96.png"> <link rel="icon" type="image/png" sizes="32x32" href="/docs/icons/favicon-32x32.png"> <link rel="icon" type="image/png" sizes="16x16" href="/docs/icons/favicon-16x16.png"> <meta name="description" content="The RIPEstat Docs Center"> <link rel="preload" href="/docs/assets/css/0.styles.338ac684.css" as="style"><link rel="preload" href="/docs/assets/js/app.f9527d9c.js" as="script"><link rel="preload" href="/docs/assets/js/7.7ded9290.js" as="script"><link rel="preload" href="/docs/assets/js/3.2ffdfbdb.js" as="script"><link rel="preload" href="/docs/assets/js/2.6e5725f7.js" as="script"><link rel="preload" href="/docs/assets/js/27.2fe910b1.js" as="script"><link rel="prefetch" href="/docs/assets/js/1.dd5c882a.js"><link rel="prefetch" href="/docs/assets/js/10.738b5c74.js"><link rel="prefetch" href="/docs/assets/js/11.971ac2bf.js"><link rel="prefetch" href="/docs/assets/js/12.67f05417.js"><link rel="prefetch" href="/docs/assets/js/13.c6f7ad37.js"><link rel="prefetch" href="/docs/assets/js/14.47032789.js"><link rel="prefetch" href="/docs/assets/js/15.deb3732b.js"><link rel="prefetch" href="/docs/assets/js/16.225b42b8.js"><link rel="prefetch" href="/docs/assets/js/17.a0ffc33d.js"><link rel="prefetch" href="/docs/assets/js/18.73beb8e2.js"><link rel="prefetch" href="/docs/assets/js/19.92fa3410.js"><link rel="prefetch" href="/docs/assets/js/20.f57d258d.js"><link rel="prefetch" href="/docs/assets/js/21.204f8c22.js"><link rel="prefetch" href="/docs/assets/js/22.09aa9af9.js"><link rel="prefetch" href="/docs/assets/js/23.4ecd63ed.js"><link rel="prefetch" href="/docs/assets/js/24.78972ef0.js"><link rel="prefetch" href="/docs/assets/js/25.886e6109.js"><link rel="prefetch" href="/docs/assets/js/26.0a623e4c.js"><link rel="prefetch" href="/docs/assets/js/28.11d6b97f.js"><link rel="prefetch" href="/docs/assets/js/29.3643bb49.js"><link rel="prefetch" href="/docs/assets/js/30.20fdfb20.js"><link rel="prefetch" href="/docs/assets/js/31.ffa760a4.js"><link rel="prefetch" href="/docs/assets/js/32.f6f7ac24.js"><link rel="prefetch" href="/docs/assets/js/33.0f65ddff.js"><link rel="prefetch" href="/docs/assets/js/34.e825f057.js"><link rel="prefetch" href="/docs/assets/js/35.7ec6266e.js"><link rel="prefetch" href="/docs/assets/js/36.bdfd8cd3.js"><link rel="prefetch" href="/docs/assets/js/37.f79198c3.js"><link rel="prefetch" href="/docs/assets/js/38.1c64b94f.js"><link rel="prefetch" href="/docs/assets/js/39.48cf696f.js"><link rel="prefetch" href="/docs/assets/js/4.7446b235.js"><link rel="prefetch" href="/docs/assets/js/40.f58d941a.js"><link rel="prefetch" href="/docs/assets/js/41.636cd812.js"><link rel="prefetch" href="/docs/assets/js/42.cd50d165.js"><link rel="prefetch" href="/docs/assets/js/43.ffe04aa3.js"><link rel="prefetch" href="/docs/assets/js/44.351a2ace.js"><link rel="prefetch" href="/docs/assets/js/45.28db5fe0.js"><link rel="prefetch" href="/docs/assets/js/46.3ff5c785.js"><link rel="prefetch" href="/docs/assets/js/47.4d2e42d8.js"><link rel="prefetch" href="/docs/assets/js/48.63205423.js"><link rel="prefetch" href="/docs/assets/js/49.696ac5fa.js"><link rel="prefetch" href="/docs/assets/js/5.3e568e49.js"><link rel="prefetch" href="/docs/assets/js/50.9926e3e4.js"><link rel="prefetch" href="/docs/assets/js/51.44e4ca1a.js"><link rel="prefetch" href="/docs/assets/js/52.1934a0d4.js"><link rel="prefetch" href="/docs/assets/js/53.383ae100.js"><link rel="prefetch" href="/docs/assets/js/54.340eab04.js"><link rel="prefetch" href="/docs/assets/js/55.273148ed.js"><link rel="prefetch" href="/docs/assets/js/56.35885504.js"><link rel="prefetch" href="/docs/assets/js/57.d8321855.js"><link rel="prefetch" href="/docs/assets/js/58.75c6969e.js"><link rel="prefetch" href="/docs/assets/js/59.ba8d259b.js"><link rel="prefetch" href="/docs/assets/js/60.36eb0882.js"><link rel="prefetch" href="/docs/assets/js/61.6b34bbdf.js"><link rel="prefetch" href="/docs/assets/js/62.e860cce0.js"><link rel="prefetch" href="/docs/assets/js/63.648ba506.js"><link rel="prefetch" href="/docs/assets/js/64.029b68d9.js"><link rel="prefetch" href="/docs/assets/js/65.6b36346e.js"><link rel="prefetch" href="/docs/assets/js/66.9d5431c2.js"><link rel="prefetch" href="/docs/assets/js/67.5d054724.js"><link rel="prefetch" href="/docs/assets/js/68.0f3b50cd.js"><link rel="prefetch" href="/docs/assets/js/69.7e2f1070.js"><link rel="prefetch" href="/docs/assets/js/70.60c23cf6.js"><link rel="prefetch" href="/docs/assets/js/71.7a66e0cc.js"><link rel="prefetch" href="/docs/assets/js/72.1a4e1a45.js"><link rel="prefetch" href="/docs/assets/js/73.89a203fc.js"><link rel="prefetch" href="/docs/assets/js/74.72bfb877.js"><link rel="prefetch" href="/docs/assets/js/75.90e8e0e7.js"><link rel="prefetch" href="/docs/assets/js/76.7e0e5c10.js"><link rel="prefetch" href="/docs/assets/js/77.354cb643.js"><link rel="prefetch" href="/docs/assets/js/78.f4a656d0.js"><link rel="prefetch" href="/docs/assets/js/79.162a399b.js"><link rel="prefetch" href="/docs/assets/js/8.665302a4.js"><link rel="prefetch" href="/docs/assets/js/80.61b5f925.js"><link rel="prefetch" href="/docs/assets/js/81.12462d6a.js"><link rel="prefetch" href="/docs/assets/js/82.3c22b3f6.js"><link rel="prefetch" href="/docs/assets/js/83.48050700.js"><link rel="prefetch" href="/docs/assets/js/84.45ab0d6b.js"><link rel="prefetch" href="/docs/assets/js/85.426ed571.js"><link rel="prefetch" href="/docs/assets/js/86.fc009680.js"><link rel="prefetch" href="/docs/assets/js/87.f3631252.js"><link rel="prefetch" href="/docs/assets/js/88.ea230bc5.js"><link rel="prefetch" href="/docs/assets/js/89.184333d1.js"><link rel="prefetch" href="/docs/assets/js/9.f0164268.js"><link rel="prefetch" href="/docs/assets/js/90.774d67cf.js"><link rel="prefetch" href="/docs/assets/js/91.03730e97.js"><link rel="prefetch" href="/docs/assets/js/92.2f751d88.js"><link rel="prefetch" href="/docs/assets/js/93.66fb6d99.js"><link rel="prefetch" href="/docs/assets/js/94.a9cf5cad.js"><link rel="prefetch" href="/docs/assets/js/95.95d9d04b.js"><link rel="prefetch" href="/docs/assets/js/96.5fdeca23.js"> <link rel="stylesheet" href="/docs/assets/css/0.styles.338ac684.css"> </head> <body> <div id="app" data-server-rendered="true"><div class="theme-container"> <header class="navbar"><div class="links"><div class="search-box"><mwc-textfield label="Search..." id="searchInput" aria-label="Search" value="" autocomplete="off" spellcheck="false"></mwc-textfield> </div></div></header> <aside class="sidebar"> <ul class="sidebar-links"><li><a href="/docs/" aria-current="page" class="sidebar-link">RIPEstat Docs Centre</a></li><li><section class="sidebar-group collapsable depth-0"><p class="sidebar-heading"><span>Getting Started</span> <span class="icon chevron right"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 256 512" aria-label="expand menu item icon" style="overflow:visible;"><path fill="transparent" stroke="currentColor" stroke-width="40" d="M17.525 36.465l-7.071 7.07c-4.686 4.686-4.686 12.284 0 16.971L205.947 256 10.454 451.494c-4.686 4.686-4.686 12.284 0 16.971l7.071 7.07c4.686 4.686 12.284 4.686 16.97 0l211.051-211.05c4.686-4.686 4.686-12.284 0-16.971L34.495 36.465c-4.686-4.687-12.284-4.687-16.97 0z"></path></svg></span></p> </section></li><li><section class="sidebar-group collapsable depth-0"><p class="sidebar-heading open"><span>Data API</span> <span class="icon chevron down"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 256 512" aria-label="expand menu item icon" style="overflow:visible;"><path fill="transparent" stroke="currentColor" stroke-width="40" d="M17.525 36.465l-7.071 7.07c-4.686 4.686-4.686 12.284 0 16.971L205.947 256 10.454 451.494c-4.686 4.686-4.686 12.284 0 16.971l7.071 7.07c4.686 4.686 12.284 4.686 16.97 0l211.051-211.05c4.686-4.686 4.686-12.284 0-16.971L34.495 36.465c-4.686-4.687-12.284-4.687-16.97 0z"></path></svg></span></p> <ul class="sidebar-links sidebar-group-items"><li><a href="/docs/02.data-api/" aria-current="page" class="active sidebar-link">RIPEstat Data API</a><ul class="sidebar-sub-headers"></ul></li><li><a href="/docs/02.data-api/abuse-contact-finder.html" class="sidebar-link">Abuse Contact Finder</a></li><li><a href="/docs/02.data-api/address-space-hierarchy.html" class="sidebar-link">Address Space Hierarchy</a></li><li><a href="/docs/02.data-api/address-space-usage.html" class="sidebar-link">Address Space Usage</a></li><li><a href="/docs/02.data-api/allocation-history.html" class="sidebar-link">Allocation History</a></li><li><a href="/docs/02.data-api/announced-prefixes.html" class="sidebar-link">Announced Prefixes</a></li><li><a href="/docs/02.data-api/as-overview.html" class="sidebar-link">AS Overview</a></li><li><a href="/docs/02.data-api/as-path-length.html" class="sidebar-link">AS Path Length</a></li><li><a href="/docs/02.data-api/as-routing-consistency.html" class="sidebar-link">AS Routing Consistency</a></li><li><a href="/docs/02.data-api/asn-neighbours.html" class="sidebar-link">ASN Neighbours</a></li><li><a href="/docs/02.data-api/asn-neighbours-history.html" class="sidebar-link">ASN Neighbours History</a></li><li><a href="/docs/02.data-api/atlas-probe-deployment.html" class="sidebar-link">Atlas Probe Deployment</a></li><li><a href="/docs/02.data-api/atlas-probes.html" class="sidebar-link">Atlas Probes</a></li><li><a href="/docs/02.data-api/atlas-targets.html" class="sidebar-link">Atlas Targets</a></li><li><a href="/docs/02.data-api/bgp-state.html" class="sidebar-link">BGP State</a></li><li><a href="/docs/02.data-api/bgp-update-activity.html" class="sidebar-link">BGP Update Activity</a></li><li><a href="/docs/02.data-api/bgp-updates.html" class="sidebar-link">BGP Updates</a></li><li><a href="/docs/02.data-api/bgplay.html" class="sidebar-link">BGPlay</a></li><li><a href="/docs/02.data-api/country-asns.html" class="sidebar-link">Country ASNs</a></li><li><a href="/docs/02.data-api/country-resource-list.html" class="sidebar-link">Country Resource List</a></li><li><a href="/docs/02.data-api/country-resource-stats.html" class="sidebar-link">Country Resource Stats</a></li><li><a href="/docs/02.data-api/dns-chain.html" class="sidebar-link">DNS Chain</a></li><li><a href="/docs/02.data-api/example-resources.html" class="sidebar-link">Example Resources</a></li><li><a href="/docs/02.data-api/historical-whois.html" class="sidebar-link">Historical Whois</a></li><li><a href="/docs/02.data-api/iana-registry-info.html" class="sidebar-link">IANA Registry Info</a></li><li><a href="/docs/02.data-api/looking-glass.html" class="sidebar-link">Looking Glass</a></li><li><a href="/docs/02.data-api/maxmind-geo-lite.html" class="sidebar-link">Maxmind Geo Lite</a></li><li><a href="/docs/02.data-api/maxmind-geo-lite-announced-by-as.html" class="sidebar-link">Maxmind Geo Lite Announced By AS</a></li><li><a href="/docs/02.data-api/meternet-bandwidth-measurements.html" class="sidebar-link">Meter.net Bandwidth Measurements</a></li><li><a href="/docs/02.data-api/mlab-activity-count.html" class="sidebar-link">M-lab Activity Count</a></li><li><a href="/docs/02.data-api/mlab-bandwidth.html" class="sidebar-link">M-lab Bandwidth</a></li><li><a href="/docs/02.data-api/mlab-clients.html" class="sidebar-link">M-lab Clients</a></li><li><a href="/docs/02.data-api/network-info.html" class="sidebar-link">Network Info</a></li><li><a href="/docs/02.data-api/prefix-count.html" class="sidebar-link">Prefix Count</a></li><li><a href="/docs/02.data-api/prefix-overview.html" class="sidebar-link">Prefix Overview</a></li><li><a href="/docs/02.data-api/prefix-routing-consistency.html" class="sidebar-link">Prefix Routing Consistency</a></li><li><a href="/docs/02.data-api/prefix-size-distribution.html" class="sidebar-link">Prefix Size Distribution</a></li><li><a href="/docs/02.data-api/related-prefixes.html" class="sidebar-link">Related Prefixes</a></li><li><a href="/docs/02.data-api/reverse-dns.html" class="sidebar-link">Reverse DNS</a></li><li><a href="/docs/02.data-api/reverse-dns-consistency.html" class="sidebar-link">Reverse DNS Consistency</a></li><li><a href="/docs/02.data-api/reverse-dns-ip.html" class="sidebar-link">Reverse DNS IP</a></li><li><a href="/docs/02.data-api/rir.html" class="sidebar-link">RIR</a></li><li><a href="/docs/02.data-api/rir-geo.html" class="sidebar-link">RIR Geo</a></li><li><a href="/docs/02.data-api/rir-prefix-size-distribution.html" class="sidebar-link">RIR Prefix Size Distribution</a></li><li><a href="/docs/02.data-api/rir-stats-country.html" class="sidebar-link">RIR Stats Country</a></li><li><a href="/docs/02.data-api/ris-asns.html" class="sidebar-link">RIS Asns</a></li><li><a href="/docs/02.data-api/ris-first-last-seen.html" class="sidebar-link">RIS First-Last-Seen</a></li><li><a href="/docs/02.data-api/ris-full-table-threshold.html" class="sidebar-link">RIS Full-Table Threshold</a></li><li><a href="/docs/02.data-api/ris-peer-count.html" class="sidebar-link">RIS Peer Count</a></li><li><a href="/docs/02.data-api/ris-peerings.html" class="sidebar-link">RIS Peerings</a></li><li><a href="/docs/02.data-api/ris-peers.html" class="sidebar-link">RIS Peers</a></li><li><a href="/docs/02.data-api/ris-prefixes.html" class="sidebar-link">RIS Prefixes</a></li><li><a href="/docs/02.data-api/routing-history.html" class="sidebar-link">Routing History</a></li><li><a href="/docs/02.data-api/routing-status.html" class="sidebar-link">Routing Status</a></li><li><a href="/docs/02.data-api/rpki-history.html" class="sidebar-link">RPKI History</a></li><li><a href="/docs/02.data-api/rpki-validation.html" class="sidebar-link">RPKI Validation Status</a></li><li><a href="/docs/02.data-api/rrc-info.html" class="sidebar-link">RRC Info</a></li><li><a href="/docs/02.data-api/searchcomplete.html" class="sidebar-link">Searchcomplete</a></li><li><a href="/docs/02.data-api/speedchecker-bandwidth-measurements.html" class="sidebar-link">Speedchecker Bandwidth Measurements</a></li><li><a href="/docs/02.data-api/visibility.html" class="sidebar-link">Visibility</a></li><li><a href="/docs/02.data-api/whats-my-ip.html" class="sidebar-link">Whats My Ip</a></li><li><a href="/docs/02.data-api/whois.html" class="sidebar-link">Whois</a></li><li><a href="/docs/02.data-api/whois-object-last-updated.html" class="sidebar-link">Whois Object Last Updated</a></li><li><a href="/docs/02.data-api/zonemaster.html" class="sidebar-link">Zonemaster</a></li></ul></section></li><li><section class="sidebar-group collapsable depth-0"><p class="sidebar-heading"><span>RIPEstat UI</span> <span class="icon chevron right"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 256 512" aria-label="expand menu item icon" style="overflow:visible;"><path fill="transparent" stroke="currentColor" stroke-width="40" d="M17.525 36.465l-7.071 7.07c-4.686 4.686-4.686 12.284 0 16.971L205.947 256 10.454 451.494c-4.686 4.686-4.686 12.284 0 16.971l7.071 7.07c4.686 4.686 12.284 4.686 16.97 0l211.051-211.05c4.686-4.686 4.686-12.284 0-16.971L34.495 36.465c-4.686-4.687-12.284-4.687-16.97 0z"></path></svg></span></p> </section></li><li><section class="sidebar-group collapsable depth-0"><p class="sidebar-heading"><span>RIPEstat UI (legacy)</span> <span class="icon chevron right"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 256 512" aria-label="expand menu item icon" style="overflow:visible;"><path fill="transparent" stroke="currentColor" stroke-width="40" d="M17.525 36.465l-7.071 7.07c-4.686 4.686-4.686 12.284 0 16.971L205.947 256 10.454 451.494c-4.686 4.686-4.686 12.284 0 16.971l7.071 7.07c4.686 4.686 12.284 4.686 16.97 0l211.051-211.05c4.686-4.686 4.686-12.284 0-16.971L34.495 36.465c-4.686-4.687-12.284-4.687-16.97 0z"></path></svg></span></p> </section></li><li><a href="/docs/05.Legal-Information.html" class="sidebar-link">Legal Information</a></li></ul> </aside> <main class="page"> <div class="theme-default-content"><div class="content__default"><h1 id="ripestat-data-api"><a href="#ripestat-data-api" class="header-anchor">#</a> RIPEstat Data API</h1> <h3 id="overview"><a href="#overview" class="header-anchor">#</a> Overview</h3> <p>The RIPEstat Data API is the public data interface for RIPEstat. It is the only data source for the <a href="https://stat.ripe.net/docs/widget_api" title="RIPEstat Widget API Docs" target="_blank" rel="noopener noreferrer">RIPEstat widgets.<span><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="icon outbound"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path> <polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg> <span class="sr-only">(opens new window)</span></span></a> and the newer <a href="https://stat.ripe.net/app/launchpad" target="_blank" rel="noopener noreferrer">RIPEstat UI<span><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="icon outbound"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path> <polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg> <span class="sr-only">(opens new window)</span></span></a></p> <h3 id="url"><a href="#url" class="header-anchor">#</a> URL</h3> <p>The basic URL for requesting data is:</p> <div class="language- extra-class"><pre><code>https://stat.ripe.net/data/<name>/data.json?param1=value1&param2=value2&... </code></pre></div><p>and to get metadata for a data call, including its methodology:</p> <div class="language- extra-class"><pre><code>https://stat.ripe.net/data/<name>/meta </code></pre></div><p>Where:</p> <ul><li>"<strong>name</strong>" is one of the data calls listed below.</li></ul> <p><strong>Note:</strong> Data call URLs previously began with <em>/plugin/</em>. This will keep working for the forseable future, but <em>/data/</em> should now be preferred.</p> <h3 id="using-data-calls"><a href="#using-data-calls" class="header-anchor">#</a> Using data calls</h3> <h4 id="common-request-parameters"><a href="#common-request-parameters" class="header-anchor">#</a> Common Request Parameters</h4> <p>To support JSON-P all RIPEstat Data API calls support a "callback" parameter. This parameter can be set to the name of the Javascript function that will be called, with the output data as its argument.</p> <table><thead><tr><th>name</th> <th>part of cache key?</th> <th>acceptable values</th> <th>default value?</th> <th>description</th></tr></thead> <tbody><tr><td>callback</td> <td>no</td> <td>-</td> <td>-</td> <td>JSON-P callback</td></tr> <tr><td>preferred_version</td> <td>yes</td> <td>version of the data call e.g. 0.1</td> <td>current stable version</td> <td>If the desired version is not available we try to return a version that is matching the major version (e.g. "0" for "0.3"). Use the meta information of a data call to retrieve all available versions, see "<a href="#MetaRequest">Getting metadata for a data call</a>". <br> <br>Magic version tags supported:<br><br>* "<strong>supported</strong>" - returns the currently supported version<br>* "<strong>upcoming</strong>" - returns the version that is either a development version and/or a candidate for the next supported version<br>* "<strong>deprecated</strong>" - this will explicitly return a deprecated version</td></tr> <tr><td>~cache~</td> <td>-</td> <td>~"ignore"~</td> <td>-</td> <td>~Bypasses and refreshes the cache when set to "ignore". Note that this should only be used when the results of a data call are stale.~ <br><strong>Temporarily disabled!</strong></td></tr></tbody></table> <h4 id="rules-of-usage"><a href="#rules-of-usage" class="header-anchor">#</a> Rules of Usage</h4> <p>These are the rules for the usage of the data API:</p> <ul><li><strong>No limit on the amount of requests</strong> but we'd like to ask you to register with us if you plan to regularly do more than 1000 requests/day, see "Regular Usage" for details.</li> <li>The system limits the usage to 8 concurrent (at the same time) requests coming from one IP address.</li> <li>RIPEstat Service Terms and Conditions apply, <a href="https://www.ripe.net/about-us/legal/ripestat-service-terms-and-conditions" target="_blank" rel="noopener noreferrer">https://www.ripe.net/about-us/legal/ripestat-service-terms-and-conditions<span><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="icon outbound"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path> <polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg> <span class="sr-only">(opens new window)</span></span></a></li></ul> <h4 id="regular-usage"><a href="#regular-usage" class="header-anchor">#</a> Regular Usage</h4> <p>If you are using the API on a regular basis with more than 1k requests per day we'd like to ask you to include a "<strong>sourceapp</strong>" parameter and so provide a unique identifier to your data call. This identifier helps us to assist you when you encounter any problems with the system. The identifier can be your project name or your company's.</p> <p><strong>Please drop us a short mail</strong> to stat@ripe.net with the identifier and an email address on which we can reach you. (If you include the purpose of the lookups, gold membership support is awaiting you 😃</p> <p>https://stat.ripe.net/data/<datacallname>/data.json?resource=AS3333&sourceapp=<YourId></p> <p>For the format please just use alphanumeric values with no whitespace and no special characters expect for hyphens and underscores.</p> <p>E.g. <strong>sourceapp=ripestat-cybersecurity-research, sourceapp=my_ripestat_id, sourceapp=as3333RIPEstat, etc.</strong></p> <h4 id="output-data-structure"><a href="#output-data-structure" class="header-anchor">#</a> Output Data Structure</h4> <p>The resulting data has a key=>value structure. Each data call has its own output fields, which are detailed in the individual sections. The common fields that are provided by every call are:</p> <table><thead><tr><th>key</th> <th>type</th> <th>value</th></tr></thead> <tbody><tr><td>status</td> <td><em>string</em></td> <td>Indicates the status of the result of the data call. Possible values are "ok" for a successful query, "error" for unsuccessful query and "maintenance" in case the data call is undergoing maintenance. In case of an error see the messages field for details.</td></tr> <tr><td>status_code</td> <td><em>integer</em></td> <td>Same as the HTTP status code. In case of server errors the HTTP status code will be set appropriately.</td></tr> <tr><td>data_call_status</td> <td><em>string</em></td> <td>Indicates the status of the data call. <br>Possible values:<br><br>* <strong>supported</strong> <br> This data call is meant to be stable and without bugs. Any bugs reported will be fixed asap.<br>* <strong>deprecated</strong>(usually provided with an expiration date) <br> This data call is meant to be deprecated and is about to be removed either by the expiration date or soon. <br> <strong>PLEASE CHECK ON THIS FLAG REGULARLY IF YOU WANT TO HAVE A RELIABLE SOURCE OF DATA!</strong><br>* <strong>development</strong> <br> This data call is currently work in progress and to be considered to change or discontinued without notice. This guarantees that we can incorporate user feedback in the most efficient way - so bug reports are highly welcome!</td></tr> <tr><td>data_call_name</td> <td><em>string</em></td> <td>Holds the name of the data call; this is useful for our team and when only the API output is available in a support request.</td></tr> <tr><td>version</td> <td><em>string</em></td> <td><em>major</em>.<em>minor</em> version of the response layout for this particular data call. New minor versions are backwards compatible, new major versions are not.</td></tr> <tr><td>cached</td> <td><em>boolean</em></td> <td>True/False</td></tr> <tr><td>message</td> <td><em>string</em></td> <td>human readable message if there was an error during processing.</td></tr> <tr><td>process_time</td> <td><em>string</em></td> <td>Time it took to process the request, in millisecons. If for some reason the time could not be determined then its value is "not available".</td></tr> <tr><td>data</td> <td></td> <td>The data itself.</td></tr></tbody></table> <h4 id="data-overload-prevention"><a href="#data-overload-prevention" class="header-anchor">#</a> Data Overload Prevention</h4> <p>The data overload prevention is to protect users, especially widgets, from getting more data than they can handle. For this reason some data calls already support a soft-limit check which returns a warning if the output looks to be more than usual.</p> <p>This prevention mechanism should only kick in if the request stems from a browser (the referrer header set), but in case it happens for a non-browser request, it can easily suppressed by the "data_overload_limit" parameter set to "ignore".</p> <p>https://stat.ripe.net/data/<datacallname>/data.json?resource=AS3333&data_overload_limit=ignore</p> <h4 id="getting-metadata-for-a-data-call"><a href="#getting-metadata-for-a-data-call" class="header-anchor">#</a> Getting metadata for a data call</h4> <p>A meta request returns additional information about a data call. A simple request to</p> <p>https://stat.ripe.net/data/<name>/meta</p> <p>will return the list of currently supported meta calls, like:</p> <ul><li><p><strong>methodology</strong><br> returns the methodology</p></li> <li><p><strong>versions</strong><br> returns all available versions</p></li> <li><p><strong>availability</strong><br> returns information on the availability of data. We provide this information to help you to identify which historical queries are possible. Hence this data is only available for data calls supporting time selection parameters.</p> <p>The output structure is a list of timelines defined by "starttime" and "endtime" properties.<br> If the data call supports different resource types the output structure will change to a list of "available_timeslines" with an "id" property describing the related resource type.</p></li></ul> <div class="language- extra-class"><pre class="language-text"><code>{ "availability": [ { "available_timelines": [ { "endtime": "2020-12-01T00:00:00", "starttime": "2008-11-01T00:00:00" } ], "id": "v4" }, { "available_timelines": [ { "endtime": "2020-01-07T00:00:00", "starttime": "2003-10-09T00:00:00" } ], "id": "v6" } ] } </code></pre></div><p>The "description" property is optional and provides information if this timeline describes a data island.</p> <div class="language- extra-class"><pre class="language-text"><code>{ "availability": { "available_timelines": [ { "endtime": "2020-01-08T09:30:00", "starttime": "2020-01-01T00:00:00" }, ... { "description": "Mediterranean Cable Cut", "endtime": "2008-02-10T23:59:59", "starttime": "2008-01-23T00:00:00" } ] } } </code></pre></div><p>The availability information can also be retrieved as part of a data call - filtered by the given resource type - by providing the parameter "meta=availability":</p> <div class="language- extra-class"><pre class="language-text"><code>https://stat.ripe.net/data/geoloc/data.json?resource=140.78/16&meta=availability </code></pre></div><p>As with a Data API call it's possible to wrap the result into an JSON-P request by appending the "callback" URL parameter, e.g. for methodology</p> <div class="language- extra-class"><pre class="language-text"><code>https://stat.ripe.net/data/&lt;name&gt;/meta/methodology?callback=callOnSuccess </code></pre></div><h3 id="note-on-ssl"><a href="#note-on-ssl" class="header-anchor">#</a> Note on SSL</h3> <p>Although it's still possible to use the RIPEstat Data API on a non-secure connection (ordinary HTTP) we strongly encourage using https. If there's a reason for you why you can't use HTTPS at all, please inform us since we will disable HTTP in the near future.</p></div> </div> <footer class="page-edit"> <div class="last-updated"><span class="prefix">Last Updated:</span> <span class="time">Tuesday, 28 March 2023</span></div></footer> <div class="page-nav"><p class="inner"><span class="prev"> ← <a href="/docs/01.getting-started/ripestat-data-sources.html" class="prev"> RIPEstat Data Sources </a></span> <span class="next"><a href="/docs/02.data-api/abuse-contact-finder.html"> Abuse Contact Finder </a> → </span></p></div> </main></div><div class="global-ui"></div></div> <script src="/docs/assets/js/app.f9527d9c.js" defer></script><script src="/docs/assets/js/7.7ded9290.js" defer></script><script src="/docs/assets/js/3.2ffdfbdb.js" defer></script><script src="/docs/assets/js/2.6e5725f7.js" defer></script><script src="/docs/assets/js/27.2fe910b1.js" defer></script> </body> </html>