MehrNet BGP

Loading network record

Base URL https://bgp-api.mehrnet.com No key, no client library. Lookup responses include meta.dataset so every answer can be traced to its source build. OpenAPI JSON

Endpoints

Lookup resources

Prefix, 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.

Services

What Mehr BGP provides

Example language

Current connection

Return the address seen by the API and its BGP, allocation, and geofeed record.

Use this for "show my IP" flows. When the API is behind Cloudflare it validates the proxy path before trusting Cloudflare client-IP headers; otherwise it falls back to the raw peer address.

GET/v1/me

Parameters

Parameter	In	Required	Description
`details`	Query	No	Return raw matched allocation, route, and geofeed candidates.

Scroll for all columns

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"))

resp, err := http.Get("https://bgp-api.mehrnet.com/v1/me")
if err != nil {
  log.Fatal(err)
}
defer resp.Body.Close()

var data map[string]any
json.NewDecoder(resp.Body).Decode(&data)

{
  "meta": {"dataset": {"release_tag": "db-2026.07.27-0913-11"}},
  "ip": "1.1.1.1",
  "version": 4,
  "registry": "apnic",
  "network": {"cidr": "1.1.1.0/24", "asn": "AS13335", "as_number": 13335},
  "location": {"country_code": "AU", "region": null, "city": null},
  "sources": {"allocation": true, "route": true, "geofeed": false}
}

IP address lookup

Resolve one IPv4 or IPv6 address into its best matching route, allocation, ASN, and location.

This is the primary service for IP intelligence. The compact response keeps the best route, best allocation, ASN number, location, and source booleans together without exposing every raw candidate by default.

GET/v1/ip/{address}

Parameters

Parameter	In	Required	Description
`address`	Path	Yes	IPv4 or IPv6 address.
`details`	Query	No	Return raw matched allocation, route, and geofeed candidates.

Scroll for all columns

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"))

resp, err := http.Get("https://bgp-api.mehrnet.com/v1/ip/1.1.1.1")
if err != nil {
  log.Fatal(err)
}
defer resp.Body.Close()

var data map[string]any
json.NewDecoder(resp.Body).Decode(&data)

{
  "meta": {"dataset": {"release_tag": "db-2026.07.27-0913-11"}},
  "ip": "1.1.1.1", "version": 4, "registry": "apnic",
  "allocation_status": "ASSIGNED PORTABLE",
  "network": {"cidr": "1.1.1.0/24", "asn": "AS13335", "name": "APNIC-LABS"},
  "allocation": {"country_code": "AU", "registry": "apnic"},
  "location": {"country_code": "AU", "region": null, "city": null},
  "sources": {"allocation": true, "route": true, "geofeed": false}
}

CIDR prefix lookup

Inspect the allocation covering a prefix and the registered route objects that overlap it.

Use prefix lookup when users click a CIDR or when you need route-object context around a network. It returns the normalized prefix descriptor, covering allocation, and paginated route matches.

GET/v1/prefix?prefix={cidr}

Parameters

Parameter	In	Required	Description
`prefix`	Query	Yes	IPv4 or IPv6 CIDR.
`limit`	Query	No	1-100 route items.
`cursor`	Query	No	Continuation cursor.

Scroll for all columns

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}"))

url := "https://bgp-api.mehrnet.com/v1/prefix?prefix=1.1.1.0%2F24&limit=10"
resp, err := http.Get(url)
if err != nil {
  log.Fatal(err)
}
defer resp.Body.Close()

var data map[string]any
json.NewDecoder(resp.Body).Decode(&data)

{
  "meta": {"dataset": {"release_tag": "db-2026.07.27-0913-11"}},
  "prefix": {"cidr": "1.1.1.0/24", "version": 4, "address_count": "256"},
  "allocation": {"registry": "apnic", "country_code": "AU", "name": "APNIC-LABS"},
  "routes": {
    "items": [{"prefix": "1.1.1.0/24", "origin_asn": "AS13335", "relation": "exact"}],
    "next_cursor": null
  }
}

Range lookup

Find allocations or route objects that overlap a start and end address.

Range lookup is for explicit start/end scans. Use kind=allocations for registry blocks or kind=routes for registered route objects overlapping the same span.

GET/v1/range?start={ip}&end={ip}

Parameters

Parameter	In	Required	Description
`start`	Query	Yes	Range start IP address.
`end`	Query	Yes	Range end IP address.
`kind`	Query	No	`allocations` by default, or `routes`.
`limit`	Query	No	1-100 items.
`cursor`	Query	No	Continuation cursor.

Scroll for all columns

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}"))

url := "https://bgp-api.mehrnet.com/v1/range?start=1.1.1.0&end=1.1.1.255&kind=routes&limit=10"
resp, err := http.Get(url)
if err != nil {
  log.Fatal(err)
}
defer resp.Body.Close()

var data map[string]any
json.NewDecoder(resp.Body).Decode(&data)

{
  "meta": {"dataset": {"release_tag": "db-2026.07.27-0913-11"}},
  "range": {"start_ip": "1.1.1.0", "end_ip": "1.1.1.255", "version": 4, "address_count": "256"},
  "kind": "routes",
  "routes": [{"prefix": "1.1.1.0/24", "origin_asn": "AS13335", "registry": "apnic"}],
  "next_cursor": null
}

ASN lookup

Fetch an autonomous system record with its registered route objects.

ASN lookup returns the retained aut-num object and a paginated route list. It accepts both AS13335 and 13335.

GET/v1/asn/{asn}

Parameters

Parameter	In	Required	Description
`asn`	Path	Yes	AS number with or without `AS`.
`limit`	Query	No	1-100 routes.
`cursor`	Query	No	Continuation cursor.

Scroll for all columns

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"))

resp, err := http.Get("https://bgp-api.mehrnet.com/v1/asn/AS13335?limit=10")
if err != nil {
  log.Fatal(err)
}
defer resp.Body.Close()

var data map[string]any
json.NewDecoder(resp.Body).Decode(&data)

{
  "meta": {"dataset": {"release_tag": "db-2026.07.27-0913-11"}},
  "asn": "AS13335", "as_number": 13335,
  "autnum": {"name": "CLOUDFLARENET-AS", "registry": "arin", "source": "ARIN"},
  "routes": {
    "items": [{"prefix": "197.234.240.0/22", "origin_asn": "AS13335", "version": 4}],
    "next_cursor": "87810"
  }
}

Search lookup

Let the API normalize a user-entered IP, CIDR, or AS number and return the matching resource.

Search is a small normalizer for user input. It returns the canonical query type and endpoint, so clients can redirect to the exact IP, prefix, or ASN resource.

GET/v1/search?q={query}

Parameters

Parameter	In	Required	Description
`q`	Query	Yes	IP address, CIDR prefix, or ASN.

Scroll for all columns

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}"))

resp, err := http.Get("https://bgp-api.mehrnet.com/v1/search?q=AS13335")
if err != nil {
  log.Fatal(err)
}
defer resp.Body.Close()

var data map[string]any
json.NewDecoder(resp.Body).Decode(&data)

{
  "query": "AS13335",
  "type": "asn",
  "normalized": "AS13335",
  "endpoint": "/v1/asn/AS13335"
}

Network lookup

Trace the network.

Lookup resources

What Mehr BGP provides

Current connection

Parameters

IP address lookup

Parameters

CIDR prefix lookup

Parameters

Range lookup

Parameters

ASN lookup

Parameters

Search lookup

Parameters