API Endpoints
Origin | https://api.a1.io |
---|---|
Authentication | None — During public Beta |
ASN data from its number
GET /asn/:asn
ASN data from its number
GET /asn/:asn
Example getting AS3 information
» REQUEST https://api.a1.io/asn/AS3
GET /asn/AS3 HTTP/1.1
Host: api.a1.io
Accept: application/json
« RESPONSE
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Cache-Control: public, s-maxage=3600, max-age=600
Content-Type: application/json; charset=utf-8
Date:
[
{
"input": "asn:3",
"error": "",
"asn": {
"asn": 3,
"rir_url": "https://rdap.arin.net/registry/autnum/3",
"name": "MIT-GATEWAYS",
"handle": "AS3",
"domain": "mit.edu",
"rir_name": "ARIN",
"type": "",
"country": "United States",
"status": "active",
"tech_handle": "SILIS-ARIN",
"registrant_handle": "MIT-2",
"registrant_type": "org",
"registrant_name": "Massachusetts Institute of Technology",
"registrant_address": "Room W92-167\r\n77 Massachusetts Avenue\nCambridge\nMA\n02139-4307\nUnited States",
"registrant_country": "United States",
"abuse_handle": "MNS18-ARIN",
"abuse_name": "MIT Network Security",
"abuse_email": "[email protected]",
"abuse_phone": "+1-617-324-1782",
"abuse_address": "304 Vassar Street\r\nW92-167\nCambridge\nMA\n02139\nUnited States",
"abuse_country": "United States",
"admin_handle": "SILIS-ARIN",
"admin_type": "individual",
"admin_name": "Mark Silis",
"admin_address": "304 Vassar Street\r\nW92-167\nCambridge\nMA\n02139\nUnited States",
"admin_phone": "+1-617-324-5900",
"admin_email": "[email protected]",
"admin_country": "United States",
"noc_handle": "",
"allocated_at": null,
"last_updated_at": "2010-09-28T07:36:02+08:00"
}
}
]
IP address to ASN data
GET /asn/ip/:ip
IP address to ASN data
GET /asn/ip/:ip
Example getting ASN data for Google Bot IP address 66.249.66.1
» REQUEST https://api.a1.io/asn/ip/66.249.66.1
GET /asn/ip/66.249.66.1 HTTP/1.1
Host: api.a1.io
Accept: application/json
« RESPONSE
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Cache-Control: public, s-maxage=3600, max-age=600
Content-Type: application/json; charset=utf-8
Date:
[
{
"input": "ip:66.249.66.1",
"error": "",
"asn": {
"asn": 15169,
"rir_url": "https://rdap.arin.net/registry/autnum/15169",
"name": "GOOGLE",
"handle": "AS15169",
"domain": "google.com",
"rir_name": "ARIN",
"type": "",
"country": "United States",
"status": "active",
"tech_handle": "ZG39-ARIN",
"registrant_handle": "GOGL",
"registrant_type": "org",
"registrant_name": "Google LLC",
"registrant_address": "1600 Amphitheatre Parkway\nMountain View\nCA\n94043\nUnited States",
"registrant_country": "United States",
"abuse_handle": "ABUSE5250-ARIN",
"abuse_name": "Abuse",
"abuse_email": "[email protected]",
"abuse_phone": "+1-650-253-0000",
"abuse_address": "1600 Amphitheatre Parkway\nMountain View\nCA\n94043\nUnited States",
"abuse_country": "United States",
"admin_handle": "ZG39-ARIN",
"admin_type": "group",
"admin_name": "Google LLC",
"admin_address": "1600 Amphitheatre Parkway\nMountain View\nCA\n94043\nUnited States",
"admin_phone": "+1-650-253-0000",
"admin_email": "[email protected]",
"admin_country": "United States",
"noc_handle": "",
"allocated_at": "2000-03-30T13:00:00+08:00",
"last_updated_at": "2012-02-24T22:44:34+08:00"
}
}
]
Company name to ASN data
GET /asn/org/:name
Company name to ASN data
GET /asn/org/:name
Example getting ASN data for Palantir Technology Inc.
» REQUEST https://api.a1.io/asn/org/palantir
GET /asn/org/palantir HTTP/1.1
Host: api.a1.io
Accept: application/json
« RESPONSE
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Cache-Control: public, s-maxage=3600, max-age=600
Content-Type: application/json; charset=utf-8
Date:
[
{
"input": "name:palantir",
"error": "",
"asn": {
"asn": 22003,
"name": "PT-ASN",
"handle": "AS22003",
"domain": "palantir.com",
"rir_name": "ARIN",
"type": "",
"country": "United States",
"status": "active",
"tech_handle": "NETWO4587-ARIN",
"registrant_handle": "PT",
"registrant_name": "PALANTIR TECHNOLOGIES INC.",
"registrant_address": "100 Hamilton Ave\r\nSuite 300\nPalo Alto\nCA\n94301\nUnited States",
"registrant_country": "United States",
"abuse_handle": "SECUR170-ARIN",
"abuse_name": "Security Team",
"abuse_email": "[email protected]",
"abuse_phone": "+1-650-815-0200",
"abuse_address": "100 Hamilton Ave\nPalo Alto\nCA\n94301\nUnited States",
"abuse_country": "United States",
"admin_handle": "NETWO4587-ARIN",
"noc_handle": "",
"allocated_at": "2010-11-09T03:33:47+08:00",
"last_updated_at": "2012-02-24T22:44:34+08:00"
}
}
]
Domain to ASN data
GET /asn/domain/:domain
Domain to ASN data
GET /asn/domain/:domain
Example getting ASN data for nasa.gov
This endpoint will lookup the A and AAAA DNS records for the domain, and fetch ASN data for all of them. The `input` value will be each resolved IP address. It is common for all IPs to belong to the same ASN.
» REQUEST https://api.a1.io/asn/domain/nasa.gov
GET /asn/domain/nasa.gov HTTP/1.1
Host: api.a1.io
Accept: application/json
« RESPONSE
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Cache-Control: public, s-maxage=3600, max-age=600
Content-Type: application/json; charset=utf-8
Date:
[
{
"input": "domain:nasa.gov/52.0.14.116",
"asn": {
"asn": 14618,
"rir_url": "https://rdap.arin.net/registry/autnum/14618",
"name": "AMAZON-AES",
"handle": "AS14618",
"domain": "amazon.com",
"rir_name": "ARIN",
"type": "",
"country": "United States",
"status": "active",
"tech_handle": "ANO24-ARIN",
"registrant_handle": "AMAZO-4",
"registrant_type": "org",
"registrant_name": "Amazon.com, Inc.",
"registrant_address": "Amazon Web Services, Inc.\r\nP.O. Box 81226\nSeattle\nWA\n98108-1226\nUnited States",
"registrant_country": "United States",
"abuse_handle": "AEA8-ARIN",
"abuse_name": "Amazon EC2 Abuse",
"abuse_email": "[email protected]",
"abuse_phone": "+1-206-555-0000",
"abuse_address": "Amazon Web Services Elastic Compute Cloud, EC2\n410 Terry Avenue North\nSeattle\nWA\n98109-5210\nUnited States",
"abuse_country": "United States",
"admin_handle": "IPMAN40-ARIN",
"admin_type": "group",
"admin_name": "IP Management",
"admin_address": "1918 8th Ave\nSeattle\nWA\n98109\nUnited States",
"admin_phone": "+1-703-464-1336",
"admin_email": "[email protected]",
"admin_country": "United States",
"noc_handle": "",
"allocated_at": "2005-11-05T03:16:14+08:00",
"last_updated_at": "2012-03-02T21:03:18+08:00"
},
"error": ""
},
{
"input": "domain:nasa.gov/23.22.39.120",
"asn": {
"asn": 14618,
"rir_url": "https://rdap.arin.net/registry/autnum/14618",
"name": "AMAZON-AES",
"handle": "AS14618",
"domain": "amazon.com",
"rir_name": "ARIN",
"type": "",
"country": "United States",
"status": "active",
"tech_handle": "ANO24-ARIN",
"registrant_handle": "AMAZO-4",
"registrant_type": "org",
"registrant_name": "Amazon.com, Inc.",
"registrant_address": "Amazon Web Services, Inc.\r\nP.O. Box 81226\nSeattle\nWA\n98108-1226\nUnited States",
"registrant_country": "United States",
"abuse_handle": "AEA8-ARIN",
"abuse_name": "Amazon EC2 Abuse",
"abuse_email": "[email protected]",
"abuse_phone": "+1-206-555-0000",
"abuse_address": "Amazon Web Services Elastic Compute Cloud, EC2\n410 Terry Avenue North\nSeattle\nWA\n98109-5210\nUnited States",
"abuse_country": "United States",
"admin_handle": "IPMAN40-ARIN",
"admin_type": "group",
"admin_name": "IP Management",
"admin_address": "1918 8th Ave\nSeattle\nWA\n98109\nUnited States",
"admin_phone": "+1-703-464-1336",
"admin_email": "[email protected]",
"admin_country": "United States",
"noc_handle": "",
"allocated_at": "2005-11-05T03:16:14+08:00",
"last_updated_at": "2012-03-02T21:03:18+08:00"
},
"error": ""
},
{
"input": "domain:nasa.gov/2600:1f18:1f:db00:807b:f1f4:d01b:30b1",
"asn": {
"asn": 14618,
"rir_url": "https://rdap.arin.net/registry/autnum/14618",
"name": "AMAZON-AES",
"handle": "AS14618",
"domain": "amazon.com",
"rir_name": "ARIN",
"type": "",
"country": "United States",
"status": "active",
"tech_handle": "ANO24-ARIN",
"registrant_handle": "AMAZO-4",
"registrant_type": "org",
"registrant_name": "Amazon.com, Inc.",
"registrant_address": "Amazon Web Services, Inc.\r\nP.O. Box 81226\nSeattle\nWA\n98108-1226\nUnited States",
"registrant_country": "United States",
"abuse_handle": "AEA8-ARIN",
"abuse_name": "Amazon EC2 Abuse",
"abuse_email": "[email protected]",
"abuse_phone": "+1-206-555-0000",
"abuse_address": "Amazon Web Services Elastic Compute Cloud, EC2\n410 Terry Avenue North\nSeattle\nWA\n98109-5210\nUnited States",
"abuse_country": "United States",
"admin_handle": "IPMAN40-ARIN",
"admin_type": "group",
"admin_name": "IP Management",
"admin_address": "1918 8th Ave\nSeattle\nWA\n98109\nUnited States",
"admin_phone": "+1-703-464-1336",
"admin_email": "[email protected]",
"admin_country": "United States",
"noc_handle": "",
"allocated_at": "2005-11-05T03:16:14+08:00",
"last_updated_at": "2012-03-02T21:03:18+08:00"
},
"error": ""
},
{
"input": "domain:nasa.gov/2600:1f18:1f:db01:11af:58af:ae11:f645",
"asn": {
"asn": 14618,
"rir_url": "https://rdap.arin.net/registry/autnum/14618",
"name": "AMAZON-AES",
"handle": "AS14618",
"domain": "amazon.com",
"rir_name": "ARIN",
"type": "",
"country": "United States",
"status": "active",
"tech_handle": "ANO24-ARIN",
"registrant_handle": "AMAZO-4",
"registrant_type": "org",
"registrant_name": "Amazon.com, Inc.",
"registrant_address": "Amazon Web Services, Inc.\r\nP.O. Box 81226\nSeattle\nWA\n98108-1226\nUnited States",
"registrant_country": "United States",
"abuse_handle": "AEA8-ARIN",
"abuse_name": "Amazon EC2 Abuse",
"abuse_email": "[email protected]",
"abuse_phone": "+1-206-555-0000",
"abuse_address": "Amazon Web Services Elastic Compute Cloud, EC2\n410 Terry Avenue North\nSeattle\nWA\n98109-5210\nUnited States",
"abuse_country": "United States",
"admin_handle": "IPMAN40-ARIN",
"admin_type": "group",
"admin_name": "IP Management",
"admin_address": "1918 8th Ave\nSeattle\nWA\n98109\nUnited States",
"admin_phone": "+1-703-464-1336",
"admin_email": "[email protected]",
"admin_country": "United States",
"noc_handle": "",
"allocated_at": "2005-11-05T03:16:14+08:00",
"last_updated_at": "2012-03-02T21:03:18+08:00"
},
"error": ""
}
]
Whois email domain to ASN data
GET /asn/whois-email/@:domain
Whois email domain to ASN data
GET /asn/whois-email/@:domain
Example fetching all ASN for registred with an @princeton.edu email address
This endpoint will query against the registrant, admin and abuse contact email address's domain.
» REQUEST https://api.a1.io/asn/whois-email/@princeton.edu
GET /asn/whois-email/@princeton.edu HTTP/1.1
Host: api.a1.io
Accept: application/json
« RESPONSE
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Cache-Control: public, s-maxage=3600, max-age=600
Content-Type: application/json; charset=utf-8
Date:
[
{
"input": "whois-email:@princeton.edu",
"asn": {
"asn": 88,
"rir_url": "https://rdap.arin.net/registry/autnum/88",
"name": "PRINCETON-AS",
"handle": "AS88",
"domain": "princeton.edu",
"rir_name": "ARIN",
"type": "",
"country": "United States",
"status": "active",
"tech_handle": "CINN-ARIN",
"registrant_handle": "PRNU-Z",
"registrant_type": "org",
"registrant_name": "Princeton University",
"registrant_address": "OIT Network Switching and Routing\n701 Carnegie Center, Suite 301\nPrinceton\nNJ\n08540\nUnited States",
"registrant_country": "United States",
"abuse_handle": "ABUSE16-ARIN",
"abuse_name": "OIT Response Team",
"abuse_email": "[email protected]",
"abuse_phone": "+1-609-258-4357;extSay this concerns network abuse",
"abuse_address": "Princeton University\r\n701 Carnegie Center, Suite 302\nPrinceton\nNJ\n08540\nUnited States",
"abuse_country": "United States",
"admin_handle": "CINN-ARIN",
"admin_type": "group",
"admin_name": "Contact for Internet numbers and names",
"admin_address": "OIT Network Switching and Routing\n701 Carnegie Center, Suite 301\nPrinceton\nNJ\n08540\nUnited States",
"admin_phone": "+1-609-258-4555",
"admin_email": "[email protected]",
"admin_country": "United States",
"noc_handle": "",
"allocated_at": "1986-10-10T12:00:00+08:00",
"last_updated_at": "2021-09-25T00:46:07+08:00"
},
"error": ""
},
{
"input": "whois-email:@princeton.edu",
"asn": {
"asn": 210934,
"rir_url": "https://rdap.db.ripe.net/autnum/210934",
"name": "YAOPEI-AS",
"handle": "AS210934",
"domain": "princeton.edu",
"rir_name": "RIPE",
"type": "",
"country": "",
"status": "active",
"tech_handle": "YP931-RIPE",
"registrant_handle": "RIPE-NCC-END-MNT",
"abuse_handle": "YP932-RIPE",
"abuse_name": "Joey Lee",
"abuse_email": "[email protected]",
"abuse_address": "12F A, Guomao Commercial Building, Nanhu Road, Nanhu Street, Luohu District, Shenzhen, China",
"abuse_country": "China",
"admin_handle": "YP931-RIPE",
"noc_handle": "",
"allocated_at": "2021-08-06T15:29:59+08:00",
"last_updated_at": "2021-08-26T22:18:11+08:00"
},
"error": ""
},
{
"input": "whois-email:@princeton.edu",
"asn": {
"asn": 400065,
"rir_url": "https://rdap.arin.net/registry/autnum/400065",
"name": "SCION-BACKBONE",
"handle": "AS400065",
"domain": "princeton.edu",
"rir_name": "ARIN",
"type": "",
"country": "United States",
"status": "active",
"tech_handle": "CINN-ARIN",
"registrant_handle": "PRNU",
"registrant_type": "org",
"registrant_name": "Princeton University",
"registrant_address": "OIT Network Switching and Routing\n701 Carnegie Center, Suite 301\nPrinceton\nNJ\n08540\nUnited States",
"registrant_country": "United States",
"abuse_handle": "ABUSE16-ARIN",
"abuse_name": "OIT Response Team",
"abuse_email": "[email protected]",
"abuse_phone": "+1-609-258-4357;extSay this concerns network abuse",
"abuse_address": "Princeton University\r\n701 Carnegie Center, Suite 302\nPrinceton\nNJ\n08540\nUnited States",
"abuse_country": "United States",
"admin_handle": "CINN-ARIN",
"admin_type": "group",
"admin_name": "Contact for Internet numbers and names",
"admin_address": "OIT Network Switching and Routing\n701 Carnegie Center, Suite 301\nPrinceton\nNJ\n08540\nUnited States",
"admin_phone": "+1-609-258-4555",
"admin_email": "[email protected]",
"admin_country": "United States",
"noc_handle": "",
"allocated_at": "2021-09-22T22:44:42+08:00",
"last_updated_at": "2021-11-22T22:02:09+08:00"
},
"error": ""
}
]
Country code to ASN data
GET /asn/country/:country-code
Country code to ASN data
GET /asn/country/:country-code
Example fetching all ASN located in Zimbabwe
This endpoint will query against the ASN country when provided by the registry, and will fallback to the ASN registrant country when not found.
» REQUEST https://api.a1.io/asn/country/zw
GET /asn/country/zw HTTP/1.1
Host: api.a1.io
Accept: application/json
« RESPONSE
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Cache-Control: public, s-maxage=3600, max-age=600
Content-Type: application/json; charset=utf-8
Date:
[
{
"input": "country:zw",
"asn": {
"asn": 18922,
"name": "ORG-AOZ1-AFRINIC",
"handle": "AS18922",
"domain": "dandemutande.co.zw",
"rir_name": "AFRINIC",
"type": "",
"country": "Zimbabwe",
"status": "active",
"tech_handle": "CM86-AFRINIC",
"registrant_handle": "ORG-AOZ1-AFRINIC",
"registrant_name": "AFRICA ONLINE ZIMBABWE",
"registrant_email": "[email protected]",
"registrant_phone": "tel:+263-242791675",
"registrant_address": "Level 9, Pegasus Building\n52-54 Samora Machel Ave\nHarare\nZimbabwe",
"registrant_country": "Zimbabwe",
"abuse_handle": "",
"admin_handle": "CM86-AFRINIC",
"noc_handle": "",
"allocated_at": "2005-02-21T23:31:00+08:00",
"last_updated_at": "2022-11-24T20:21:00+08:00"
},
"error": ""
},
{
"input": "country:zw",
"asn": {
"asn": 37204,
"name": "ORG-TPL1-AFRINIC",
"handle": "AS37204",
"domain": "telone.co.zw",
"rir_name": "AFRINIC",
"type": "",
"country": "Zimbabwe",
"status": "active",
"tech_handle": "PC21-AFRINIC",
"registrant_handle": "ORG-TPL1-AFRINIC",
"registrant_name": "Telone PVT Ltd",
"registrant_email": "[email protected]",
"registrant_phone": "tel:+263-4-792-272",
"registrant_address": "Telone HQ\n107 Kwame Nkruma Ave\nHarare, Zimbabwe",
"registrant_country": "Zimbabwe",
"abuse_handle": "",
"admin_handle": "TC6-AFRINIC",
"noc_handle": "",
"allocated_at": "2010-04-16T20:38:00+08:00",
"last_updated_at": "2023-07-11T05:54:00+08:00"
},
"error": ""
}
]
ASN to IP ranges
GET /asn/:asn/prefixes
ASN to IP ranges
GET /asn/:asn/prefixes
Example fetching all IP ranges for the MIT under their AS3
IP ranges are also called prefixes, routes or netblocks. These ranges are announced by BGP routers, which call them prefixes.
Append `.csv` to this endpoint to get a response in CSV format. Each route’ RPKI validity is included when available.
» REQUEST https://api.a1.io/asn/AS3/prefixes
GET /asn/AS3/prefixes HTTP/1.1
Host: api.a1.io
Accept: application/json
« RESPONSE
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Cache-Control: public, s-maxage=3600, max-age=600
Content-Type: application/json; charset=utf-8
Date:
[
{
"netblock": "128.30.0.0/15",
"name": "NET128",
"company_name": "Various Registries (Maintained by ARIN)",
"registry": "ARIN",
"ip_count": 131070,
"ip_version": 4,
"visibility": 100,
"country": "United States",
"domain": "example.com",
"roa_validity": "not-found"
},
{
"netblock": "18.0.0.0/16",
"name": "MIT",
"company_name": "Massachusetts Institute of Technology",
"registry": "ARIN",
"ip_count": 65534,
"ip_version": 4,
"visibility": 100,
"country": "United States",
"domain": "mit.edu",
"roa_validity": "not-found"
},
{
"netblock": "18.1.0.0/16",
"name": "MIT",
"company_name": "Massachusetts Institute of Technology",
"registry": "ARIN",
"ip_count": 65534,
"ip_version": 4,
"visibility": 100,
"country": "United States",
"domain": "mit.edu",
"roa_validity": "not-found"
},
{
"netblock": "18.3.0.0/16",
"name": "MIT",
"company_name": "Massachusetts Institute of Technology",
"registry": "ARIN",
"ip_count": 65534,
"ip_version": 4,
"visibility": 100,
"country": "United States",
"domain": "mit.edu",
"roa_validity": "not-found"
},
{
"netblock": "18.4.0.0/16",
"name": "MIT",
"company_name": "Massachusetts Institute of Technology",
"registry": "ARIN",
"ip_count": 65534,
"ip_version": 4,
"visibility": 100,
"country": "United States",
"domain": "mit.edu",
"roa_validity": "not-found"
},
// A lot more...
]
Your current IP to ASN data
GET /asn/me
Your current IP to ASN data
GET /asn/me
Return the ASN data for the IP address you are connecting from
This will most likely return your ISP ASN if you query from home, your VPN provider ASN, or your cloud provider’ if queried from your online server.
» REQUEST https://api.a1.io/asn/me
GET /asn/me HTTP/1.1
Host: api.a1.io
Accept: application/json
« RESPONSE
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Cache-Control: public, s-maxage=3600, max-age=600
Content-Type: application/json; charset=utf-8
Date:
[
{
"input": "ip:197.214.88.42",
"asn": {
"asn": 37559,
"rir_url": "https://rdap.afrinic.net/rdap/autnum/AS37559",
"name": "ORG-OB4-AFRINIC",
"handle": "AS37559",
"domain": "orange.com",
"rir_name": "AFRINIC",
"type": "",
"country": "",
"status": "active",
"tech_handle": "PM60-AFRINIC",
"registrant_handle": "ORG-OB4-AFRINIC",
"registrant_type": "org",
"registrant_name": "Orange Bissau",
"registrant_email": "[email protected]",
"registrant_phone": "tel:+245-955-603-030",
"registrant_address": "Praca dos Herois Nacionais\nBP 1087 Bissau\nBissau",
"abuse_handle": "",
"admin_handle": "HC20-AFRINIC",
"admin_type": "individual",
"admin_name": "Hervé CLEMENT",
"admin_address": "Orange Gardens\n44 Avenue de la République\nCS 50010\n92326 Chatillon Cedex – France",
"admin_phone": "tel:+33-1-57-39-77-97",
"admin_email": "[email protected]",
"admin_country": "France",
"noc_handle": "",
"allocated_at": "2013-02-15T21:24:00+08:00",
"last_updated_at": "2019-07-01T18:32:00+08:00"
}
"error": ""
}
]
- Batch queries are possible. Separate inputs with a comma. Example:
api.a1.io/asn/AS3,AS5,AS13335 - A maximum of 50 results per query is returned. Get in touch for more »
Caching, Terms, Legalese
- Cloudflare caches data for 2 hours, your browser for 1 day.
- All data offered at https://a1.io is provided without any warranty. Get in touch for data access with SLA.
- You expressly understand and agree that a1.io shall not be liable to you for any monetary, data, business or goodwill damages which may be incurred by you, however caused and under any theory of liability.