# BGPv6.com - BGP Routing Intelligence Platform

BGPv6.com is a free, publicly accessible BGP (Border Gateway Protocol) analysis platform
providing real-time routing table data, ASN lookups, IP prefix analysis, and network intelligence.

## What BGPv6.com provides

- **IP / Prefix Lookup**: Given any IPv4 or IPv6 address or CIDR prefix, returns the origin ASN,
  AS-path, RPKI validation status, RIR, and country of origin.
- **ASN Information**: For any Autonomous System Number (AS{n}), returns the ASN name, description,
  country, RIR, IPv4 prefix count, IPv6 prefix count, upstream peers, and routing table prefixes.
- **BGP Peer Relationships**: Maps upstream/downstream relationships between ASNs derived from
  AS-path analysis across 8+ BGP route collectors (RIPE RIS + RouteViews).
- **Country Statistics**: Lists all countries with their ASN count, IPv4 prefix count, and IPv6
  adoption metrics.
- **Search**: Full-text search across ASN names, descriptions, and prefixes.

## Data Sources

- RIPE NCC Routing Information Service (RIS) — rrc00, rrc01, rrc03, rrc04, rrc05
- RouteViews Project — route-views2, route-views6, route-views.linx
- RDAP (Registration Data Access Protocol) for ASN metadata
- RPKI (Resource Public Key Infrastructure) for prefix validation
- MaxMind GeoIP for geographic attribution
- Data refreshed daily from MRT table dump files

## API

Base URL: https://bgpv6.com/api/v1

### IP/Prefix Lookup
GET /api/v1/lookup/{ip_or_prefix}
Returns: origin_asn, prefix, as_path, rpki_status, is_ipv6, source

### ASN Information
GET /api/v1/asn/{asn_number}
Returns: asn, name, description, country, rir, prefix_v4, prefix_v6, updated_at

### ASN Prefixes
GET /api/v1/asn/{asn_number}/prefixes
Returns: array of prefixes with origin_asn, is_ipv6, rpki_status, as_path

### Search
GET /api/v1/search?q={query}
Returns: matched ASNs with name, country, rir, prefix counts

### GeoIP Lookup
GET /api/v1/geoip/{ip}
Returns: country, city, latitude, longitude, asn, org

## Usage Notes for AI Agents

- All endpoints return JSON.
- ASN numbers are integers (e.g., 15169 for Google, 32934 for Meta, 2914 for NTT).
- Prefixes are in CIDR notation: "8.8.8.0/24" (IPv4) or "2001:db8::/32" (IPv6).
- RPKI status values: "valid", "invalid", "unknown", "not-found".
- Rate limit: 100 requests per 60 seconds per IP.
- No authentication required. No API key needed.

## Example Queries

- Look up an IP address: GET /api/v1/lookup/8.8.8.8
- Look up a prefix: GET /api/v1/lookup/1.1.1.0/24
- Get Google's ASN info: GET /api/v1/asn/15169
- Search for Cloudflare: GET /api/v1/search?q=cloudflare
- Get GeoIP for an IP: GET /api/v1/geoip/8.8.8.8

## Contact

Website: https://bgpv6.com
Data last updated: daily at 01:00 UTC