Network intelligence
Public API
JSON over HTTPS, no API key required. Responses are served from the daily materialized BGP dataset.
https://bgp-api.mehrnet.com
All endpoints return JSON. Lookup responses include meta.dataset; health also reports the running binary build.
OpenAPI JSON
GET /v1/meCurrent connection addressGET /v1/ip/{address}IPv4 or IPv6 addressGET /v1/prefix?prefix={cidr}Allocation and registered route objectsGET /v1/range?start={ip}&end={ip}Overlapping allocationsGET /v1/range?...&kind=routesOverlapping registered routesGET /v1/asn/{asn}Aut-num record and routesGET /v1/search?q={query}Normalize an IP, CIDR, or ASNGET /v1/healthService health and active dataset metadataPrefix, range, and ASN endpoints accept limit from 1 to 100 and return next_cursor when another page is available. IP and current-connection lookups accept details=full when raw matched records are needed. Direct RPSL abuse-c and abuse-mailbox values are returned as abuse_contact when present in the daily dataset.
Return the address seen by the API and its BGP, allocation, and geofeed record.
curl -sS "https://bgp-api.mehrnet.com/v1/me"const response = await fetch("https://bgp-api.mehrnet.com/v1/me");
const data = await response.json();$json = file_get_contents("https://bgp-api.mehrnet.com/v1/me");
$data = json_decode($json, true);from urllib.request import urlopen
import json
data = json.load(urlopen("https://bgp-api.mehrnet.com/v1/me"))Resolve one IPv4 or IPv6 address into its best matching route, allocation, ASN, and location.
curl -sS "https://bgp-api.mehrnet.com/v1/ip/1.1.1.1"const response = await fetch("https://bgp-api.mehrnet.com/v1/ip/1.1.1.1");
const data = await response.json();$json = file_get_contents("https://bgp-api.mehrnet.com/v1/ip/1.1.1.1");
$data = json_decode($json, true);from urllib.request import urlopen
import json
data = json.load(urlopen("https://bgp-api.mehrnet.com/v1/ip/1.1.1.1"))Inspect the allocation covering a prefix and the registered route objects that overlap it.
curl -sS "https://bgp-api.mehrnet.com/v1/prefix?prefix=1.1.1.0%2F24&limit=10"const url = new URL("https://bgp-api.mehrnet.com/v1/prefix");
url.searchParams.set("prefix", "1.1.1.0/24");
url.searchParams.set("limit", "10");
const data = await (await fetch(url)).json();$url = "https://bgp-api.mehrnet.com/v1/prefix?prefix=" . rawurlencode("1.1.1.0/24") . "&limit=10";
$data = json_decode(file_get_contents($url), true);from urllib.parse import urlencode
from urllib.request import urlopen
import json
query = urlencode({"prefix": "1.1.1.0/24", "limit": "10"})
data = json.load(urlopen(f"https://bgp-api.mehrnet.com/v1/prefix?{query}"))Find allocations or route objects that overlap a start and end address.
curl -sS "https://bgp-api.mehrnet.com/v1/range?start=1.1.1.0&end=1.1.1.255&kind=routes&limit=10"const url = new URL("https://bgp-api.mehrnet.com/v1/range");
url.searchParams.set("start", "1.1.1.0");
url.searchParams.set("end", "1.1.1.255");
url.searchParams.set("kind", "routes");
const data = await (await fetch(url)).json();$params = http_build_query([
"start" => "1.1.1.0",
"end" => "1.1.1.255",
"kind" => "routes",
"limit" => "10",
]);
$data = json_decode(file_get_contents("https://bgp-api.mehrnet.com/v1/range?" . $params), true);from urllib.parse import urlencode
from urllib.request import urlopen
import json
query = urlencode({"start": "1.1.1.0", "end": "1.1.1.255", "kind": "routes", "limit": "10"})
data = json.load(urlopen(f"https://bgp-api.mehrnet.com/v1/range?{query}"))Fetch an autonomous system record with its registered route objects.
curl -sS "https://bgp-api.mehrnet.com/v1/asn/AS13335?limit=10"const response = await fetch("https://bgp-api.mehrnet.com/v1/asn/AS13335?limit=10");
const data = await response.json();$json = file_get_contents("https://bgp-api.mehrnet.com/v1/asn/AS13335?limit=10");
$data = json_decode($json, true);from urllib.request import urlopen
import json
data = json.load(urlopen("https://bgp-api.mehrnet.com/v1/asn/AS13335?limit=10"))Let the API normalize a user-entered IP, CIDR, range, or AS number and return the matching resource.
curl -sS "https://bgp-api.mehrnet.com/v1/search?q=AS13335"const url = new URL("https://bgp-api.mehrnet.com/v1/search");
url.searchParams.set("q", "AS13335");
const data = await (await fetch(url)).json();$url = "https://bgp-api.mehrnet.com/v1/search?q=" . rawurlencode("AS13335");
$data = json_decode(file_get_contents($url), true);from urllib.parse import urlencode
from urllib.request import urlopen
import json
query = urlencode({"q": "AS13335"})
data = json.load(urlopen(f"https://bgp-api.mehrnet.com/v1/search?{query}"))