MehrNet BGP

Loading network record

Base URL https://bgp-api.mehrnet.com All endpoints return JSON. Lookup responses include meta.dataset; health also reports the running binary build. OpenAPI JSON

Endpoints

Lookup resources

GET /v1/meCurrent connection address

GET /v1/ip/{address}IPv4 or IPv6 address

GET /v1/prefix?prefix={cidr}Allocation and registered route objects

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

GET /v1/range?...&kind=routesOverlapping registered routes

GET /v1/asn/{asn}Aut-num record and routes

GET /v1/search?q={query}Normalize an IP, CIDR, or ASN

GET /v1/healthService health and active dataset metadata

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.

Endpoint: GET /v1/me
Returns: Same compact lookup object as /v1/ip/{address}

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)

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.

Endpoint: GET /v1/ip/{address}
Optional: ?details=full includes matched allocation, route, and geofeed candidates

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)

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.

Endpoint: GET /v1/prefix?prefix={cidr}
Pagination: limit and cursor apply to route matches

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)

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.

Endpoint: GET /v1/range?start={ip}&end={ip}
Kind: allocations by default, or routes

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)

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.

Endpoint: GET /v1/asn/{asn}
Pagination: limit and cursor apply to routes

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)

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.

Endpoint: GET /v1/search?q={query}
Recognizes: IP addresses, CIDR prefixes, and ASNs

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)

Response

Expected lookup object

meta.datasetRelease tag, build time, activation time, and producer commit.

ipCanonical IPv4 or IPv6 address that was looked up.

networkBest matching route, ASN list, ASN number, network name, and abuse contact when present.

allocationBest retained allocation object: registry, range, country, status, and source fields.

locationGeofeed-derived country, region, and city when available.

sourcesBooleans showing whether allocation, route, and geofeed data contributed to the result.

detailsOnly present with ?details=full; contains matched candidate records.

{
  "meta": {
    "dataset": {
      "release_tag": "db-2026.07.27-0913-11",
      "built_at": "2026-07-27T09:13:59Z",
      "activated_at": "2026-07-27 09:38:18.275618+00",
      "source_commit": "ac9d817ae1e35b3850b17fa0ab7bba32319969e8"
    }
  },
  "ip": "1.1.1.1",
  "version": 4,
  "registry": "apnic",
  "allocation_date": null,
  "allocation_status": "ASSIGNED PORTABLE",
  "network": {
    "cidr": "1.1.1.0/24",
    "start_ip": "1.1.1.0",
    "end_ip": "1.1.1.255",
    "asn": "AS13335",
    "asns": ["AS13335"],
    "as_number": 13335,
    "name": "APNIC-LABS",
    "status": null,
    "abuse_contact": null
  },
  "allocation": {
    "start_ip": "1.1.1.0",
    "end_ip": "1.1.1.255",
    "registry": "apnic",
    "country_code": "AU",
    "country_raw": "AU",
    "name": "APNIC-LABS",
    "allocation_date": null,
    "status": "ASSIGNED PORTABLE",
    "abuse_contact": "AA1412-AP"
  },
  "location": {
    "country_code": "AU",
    "region": null,
    "city": null
  },
  "sources": {
    "allocation": true,
    "route": true,
    "geofeed": false
  }
}

Use ?details=full on /v1/ip/{address} or /v1/me when you need the raw matched allocation, route, and geofeed candidates behind the compact response.

Network lookup

Build with Mehr BGP