---
title: "Host Reputation"
method: GET
path: "/host-reputation"
tags: ["Security and Networking"]
---

# Host Reputation

`GET /host-reputation`

Check the reputation of an IP address, domain name or URL against a comprehensive list of blacklists and blocklists

## Query parameters

- `host` string, required
- `list-rating` integer
- `zones` string

## Response `200`

OK

- HostReputationResponse — Structure of host-reputation
  - `is-listed` boolean, required — Is this host blacklisted
  - `lists` Blacklist[], required — Array of objects for each DNSBL checked
    - `is-listed` boolean, required — True if the host is currently black-listed
    - `list-host` string, required — The hostname of the DNSBL
    - `list-rating` integer, required — The list rating [1-3] with 1 being the best rating and 3 the lowest rating
    - `list-name` string, required — The name of the DNSBL
    - `txt-record` string, required — The TXT record returned for this listing (only set if listed)
    - `return-code` string, required — The specific return code for this listing (only set if listed)
    - `response-time` integer, required — The DNSBL server response time in milliseconds
  - `list-count` integer, required — The number of DNSBLs the host is listed on
  - `host` string, required — The IP address or host name

## Other responses

- `400` — Your API request has been rejected. Check error code for details
- `403` — You have failed to authenticate
- `500` — We messed up, sorry! Your request has caused a fatal exception
- `default` — We messed up, sorry! Your request has caused an error

---

[API](https://skmtc.net/neutrinoapi/apis/neutrino-api.md) · [All operations](https://skmtc.net/neutrinoapi/apis/neutrino-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/neutrinoapi/neutrino-api/revisions/4ebd6b56de42/schema)
