asn-from-ip

IP to ASN

This tiny package allows you to obtain ASN meta information for any IP address. Some IP addresses are of course not assigned to an ASN.

Installation

npm install ip_to_asn

If you want to clone the repository directly from GitHub instead:

git clone [e-mail]:ipapi-is/ip_to_asn.git

Usage

Lookup the IP address 144.168.164.55:

const { ipToASN } = require('ip_to_asn');

(async () => {
  console.log(await ipToASN('144.168.164.55'));
})();

which outputs (at the time of writing):

{
  asn: 55286,
  route: '144.168.160.0/21',
  descr: 'SERVER-MANIA, CA',
  country: 'ca',
  active: true,
  org: 'B2 Net Solutions Inc.',
  domain: 'www.servermania.com',
  abuse: '[e-mail]',
  type: 'hosting',
  created: '2013-05-16',
  updated: '2013-05-16',
  rir: 'arin',
  whois: 'https://ipapi.is/json/?whois=AS55286'
}

Most IP addresses can be associated with an Autonomeous System (AS). The return value of ipToASN() is an object with the following attributes:

• asn - int - The AS number
• route - string - The IP route as CIDR in this AS
• descr - string - An informational description of the AS
• country - string - The country where the AS is situated in (administratively)
• active - string - Whether the AS is active (active = at least one route administred by the AS)
• domain - string - The domain of the organization to which this AS belongs
• org - string - The organization responisible for this AS
• type - string - The type for this ASN, this is either hosting, education, goverment, banking, business or isp
• created - string - When the ASN was established
• updated - string - The last time the ASN was updated
• rir - string - To which Regional Internet Registry the ASN belongs
• whois - string - An url to the whois information for this ASN

For inactive autonomeous systems, most of the above information is not available.