Download Peerings List From IXP Manager

Downloading Peering Lists from IXP Manager

Most Internet Exchange Points use dedicated management systems to maintain peering information. This guide explains how to obtain the peering list from your IXP management system for use with the Digital Twin.

Overview

The Digital Twin requires a list of connected peers to accurately simulate your IXP's BGP environment. This list defines the customer ASes, their IP addresses, and MAC addresses that will be tested.

Many IXP operators use IXP Manager or similar management platforms that provide APIs or export options for peering configuration. The exported file should be in JSON format compatible with the IXP Manager standard.

Obtaining the Peering List

From IXP Manager API

If your IXP Manager provides an API endpoint for exporting peering configuration:

curl -s "https://your-ixp-manager.example.com/api/v4/peeringdb-export/ixf/config_peerings.json" \
  > peerings.json

The typical API path structure is /api/v4/peeringdb-export/ixf/config_peerings.json. Replace your-ixp-manager.example.com with your actual IXP Manager hostname.

If your API requires authentication:

curl -s -H "Authorization: Bearer YOUR_API_TOKEN" \
  "https://your-ixp-manager.example.com/api/v4/peeringdb-export/ixf/config_peerings.json" \
  > peerings.json

Manual Export

If your IXP Manager provides a web interface:

1. Log in to your IXP Manager
2. Navigate to the peering or member export section
3. Select the JSON export format
4. Download the file and save it as peerings.json

File Format

The peering list follows the IXP Manager IXF (Internet eXchange Forum) format, a comprehensive JSON structure containing IXP and member information:

{
  "version": "1.0",
  "generator": "IXP Manager v6.3.0",
  "timestamp": "2026-02-12T18:12:27Z",
  "ixp_list": [
    {
      "shortname": "IXP Name",
      "name": "Full IXP Name",
      "country": "IT",
      "peeringdb_id": 121,
      "vlan": [
        {
          "id": 1,
          "name": "Public Peering",
          "ipv4": {
            "prefix": "192.0.2.0",
            "mask_length": 24
          },
          "ipv6": {
            "prefix": "2001:db8::",
            "mask_length": 64
          }
        }
      ]
    }
  ],
  "member_list": [
    {
      "asnum": 1234,
      "name": "EXAMPLE-AS",
      "url": "https://example.com",
      "peering_policy": "open",
      "connection_list": [
        {
          "ixp_id": 1,
          "state": "active",
          "vlan_list": [
            {
              "vlan_id": 1,
              "ipv4": {
                "address": "192.0.2.10",
                "routeserver": true,
                "mac_addresses": ["00:11:22:33:44:55"],
                "max_prefix": 250
              },
              "ipv6": {
                "address": "2001:db8::10",
                "routeserver": true,
                "mac_addresses": ["00:11:22:33:44:55"],
                "max_prefix": 250
              }
            }
          ]
        }
      ]
    }
  ]
}