PeeringDB API

Base URL

https://www.peeringdb.com/api

Authentication

Anonymous reads work for the main object types. A free registered API key raises rate limits and reveals contact records that anonymous callers cannot see.

Rate limit

Anonymous requests are throttled more tightly than authenticated ones. PeeringDB asks integrators to register a key and cache rather than polling.

Pricing

Free. PeeringDB is a non-profit funded by the networking community.

CORS

Enabled — callable directly from browser JavaScript

Official docs

Read the docs

Every request below was executed against the live API on 21 Aug 2026, and the response shown is the real body it returned — not an illustration.

curl 'https://www.peeringdb.com/api/net?limit=2'

const res = await fetch("https://www.peeringdb.com/api/net?limit=2");
if (!res.ok) throw new Error(`Request failed: ${res.status}`);
const data = await res.json();
console.log(data);

import requests

res = requests.get("https://www.peeringdb.com/api/net?limit=2", timeout=20)
res.raise_for_status()
print(res.json())

{
  "data": [
    {
      "id": 1,
      "org_id": 8897,
      "name": "GTT Communications (AS4436)",
      "aka": "Formerly known as nLayer Communications",
      "name_long": "",
      "website": "http://www.gtt.net",
      "social_media": [
        {
          "service": "website",
          "identifier": "http://www.gtt.net"
        }
      ],
      "asn": 4436,
      "looking_glass": "",
      "route_server": "",
      "irr_as_set": "",
      "info_type": "NSP",
      "info_types": [
        "NSP"
      ],
      "info_prefixes4": 200000,
      "info_prefixes6": 10000,
      "info_traffic": "",
      "info_ratio": "",
      "info_scope": "Global",
      "info_unicast": true,
      "info_multicast": false,
      "info_ipv6": true,
      "info_never_via_route_servers": false,
      "ix_count": 0,
      "fac_count": 0,
      "notes": "nLayer / AS4436 has been acquired by GTT Communications / AS3257 and is no longer directly peering.  Please refer all peering related inquiries to peering [at] gtt [dot] net.",
      "netixlan_updated": "2021-09-22T00:06:59Z",
      "netfac_updated": "2016-09-19T05:47:27Z",
      "poc_updated": "2016-03-14T21:53:18Z",
      "policy_url": "http://www.gtt.net/peering/",
      "policy_general": "Restrictive",
      "policy_locations": "Required - International",
      "policy_ratio": true,
      "policy_contracts": "Required",
      "allow_ixp_update": false,
      "ixp_update_exclude": [],
      "status_dashboard": null,
      "rir_status": "ok",
      "rir_status_updated": "2024-06-26T04:47:55Z",
      "logo": null,
      "created": "2004-07-2

dataarray

The records. Every response wraps results in `data`, even single-object lookups, so always index into it.

asninteger

AS number. Unlike some routing APIs this really is an integer here.

name / aka / name_longstring

Primary name plus alternatives. `aka` frequently records a former company name after an acquisition, which is genuinely useful history.

info_type / info_typesstring / array

Network category such as `NSP`, `Content` or `Cable/DSL/ISP`. Both the legacy single field and the newer array are returned.

info_prefixes4 / info_prefixes6integer

Self-declared maximum prefix counts, which peers use to set session limits. Self-reported, so treat as a hint.

policy_generalstring

Peering policy: `Open`, `Selective`, `Restrictive` or `No`. The single most consulted field in the dataset.

policy_url / policy_locations / policy_ratiostring / boolean

Where the policy is published, whether multiple locations are required, and whether a traffic ratio requirement applies.

ix_count / fac_countinteger

How many exchanges and facilities the network is present at. Zero often means a stale record rather than genuine absence.

notesstring

Free-text operator notes, often explaining mergers or where to send peering requests.

rir_statusstring

Whether the ASN is still allocated according to the RIRs, with `rir_status_updated` alongside. A useful staleness signal.

• Find out where you can peer with a given network before an interconnection request
• Look up a network's peering policy and contact route from an ASN in your logs
• Map which networks are present at a particular exchange or data centre
• Enrich traffic analytics with network type and traffic profile
• Audit your own PeeringDB record for stale or missing information

If PeeringDB does not fit, these developer & testing apis cover similar ground. Every one was called before publishing, and each links to its own reference page with a working curl command and the response it returned.