BGP IPv4 Active Prefixes API

Introduction

This API returns IPv4 address space routes/prefixes which are currently announced on BGP.

Unprecedented Update Rate

  • BGP data: Updated every 2 hours

Example Response

The response is only available in JSON format. The below response should be expected for the following request:



Awaiting request submission...

API Pricing

  1. Monthly Subscription
    FREE 10,000 queries/month
    Additional 10,000 queries US$1.00/month
  2. Annual Subscription
    FREE 10,000 queries/month
    Additional 10,000 queries US$0.80/month

Request Format

NEW! Payload compression is supported, simply add Accept-Encoding: gzip header.
Use the form below to try out this API.

Parameter Your Input Value Description
bogonsOnly Limit to bogon routes only or not. Default – no limit
batchSize Requested batch size. Maximum value = 1000
offset Offset. Number of entries to skip
sort

Sort response by a field value, acceptable values:

·       bgpPrefix

·       bgpPrefixNetworkAddress

·       bgpPrefixLastAddress

·       registryStatus

·       isBogon

·       isAnnounced

Default – sorted by bgpPrefixNetworkAddress

order Sort order, acceptable values: asc, desc. Default - asc
asn Autonomous System Number as numeric or ASN format (e.g. 123 or AS123 or ASN123)
localityLanguage

Preferred language for locality names in ISO 639-1 format, such as 'en' for English, 'es' for Spanish etc. Please note: 147 common world languages are supported, full list here, but not all languages are available for every location. If requested language is not available for a requested location it will default to English, if no English is available, the native, local names will be provided

key Your API key

Don't have an API Key? Click here to register and get your free API Key

If you already have a BigDataCloud account, to automatically fill this field with your Api Key.



Response

Awaiting request submission...

Response Format

Field

Data type

Description

total

16 bit unsigned integer

Total prefixes found

offset

32 bit unsigned integer

Number of entries skipped

batch

16 bit unsigned integer

Number of entries in the current batch

prefixes

Array of <Prefix> objects

Array of prefix entries returned

Data Objects

Prefix Object

Field

Data type

Description

bgpPrefix

string

BGP prefix in CIDR format

bgpPrefixNetworkAddress

string

BGP prefix network (first) address

bgpPrefixLastAddress

string

BGP prefix last address

registryStatus

string

Registration status

isBogon

boolean

Indicates if the network in bogon

isAnnounced

boolean

Indicates if the network is announced

carriers

Array of <CarrierShort> objects

List of Autonomous Systems (AS) announcing this prefix on BGP

CarrierShort object

Field

Data type

Description

asn

string

Autonomous System Number string

asnNumeric

32 bit unsigned integer

Autonomous System Number

organisation

string

Registered Organisation

name

string

Registered name

registry

string

The Regional Internet Registry (RIR) the AS is registered with

registeredCountry

string

Registered Country ISO 3166-1 Alpha-2 code

registeredCountryName

string

Registered Country localised name. The language is as defined by ‘localityLanguage’ request parameter

rank

32 bit unsigned integer

World rank by total number of IP addresses announced

 

Related APIs