Skip to main content
GET
ASN reputation

Authorizations

apiKey
string
query
required

Your API key, passed as the apiKey query parameter on every request. A key sent in a header (Authorization or X-API-Key) is not accepted and gets 401.

Path Parameters

asn
integer
required

The AS number, without the AS prefix: 13335, not AS13335.

Required range: 0 <= x <= 2147483647

Response

Successful Response

asn
integer
required

The AS number you asked for.

asn_name
string | null
required

The ASN's registered name as we hold it, or null.

asn_type
enum<string>
required

A rough network type, guessed from keywords in the ASN's registered name; enterprise when no keyword matches. A hint, not a classification.

Available options:
cdn,
hosting,
mobile,
residential,
enterprise
abuse_score
integer
required

0 to 100, higher is worse. It is not a percentage.

Required range: 0 <= x <= 100
abuse_level
enum<string>
required

clean (below 20), low (20 to 39), moderate (40 to 59), high (60 to 79) or critical (80 and up).

Available options:
clean,
low,
moderate,
high,
critical
flagged_ratio
number
required

Our flagged IPv4 range entries in the ASN, each counted once whatever its size, divided by the IPv4 addresses the ASN announces, capped at 1; 0 when we know of no announced IPv4 space. It is neither a share of addresses nor a share of traffic.

Required range: 0 <= x <= 1
counts
object
required

Our classified range entries in the ASN for five classes, each entry counted once whatever its size, so these are not address counts. Residential proxy exits we observe one by one are not range entries and are not counted here.

avg_ip_persistence_days
number | null
required

The average number of days between first and last sighting across our flagged entries in the ASN.

new_flags_last_30d
integer
required

Flagged entries in the ASN first seen in the 30 days before computed_at.

Required range: x >= 0
computed_at
string | null
required

When the score was computed, in ISO 8601.