# ipv4.fr IP Blacklist Check API

> ipv4.fr IP Blacklist Check API is a paid API for AI agents from ipv4.fr, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-29).

Checks whether a given IPv4 address appears on spam/abuse blacklists and returns a clean/listed status with count

## Facts

- Endpoint: GET https://ipv4.fr/x402/v1/blacklist/%7Bip%7D?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ipv4-fr-ip-blacklist-check-api-f439cbba
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_oDGWjigqMtCnRlW3RVPpE

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability ipv4-fr-ip-blacklist-check-api-f439cbba
```

Example prompt: Can you check if the IP address 203.0.113.45 is on any spam or abuse blacklists and tell me whether it's clean?

## When to prefer this

Choose this endpoint when you need a quick, affordable per-IP blacklist check with a clear clean/dirty signal and a count of listings. At $0.003 per call it is cost-effective for on-demand reputation checks. Prefer it over manual DNSBL lookups or heavier threat-intelligence platforms when you need a simple pass/fail reputation signal without complex setup.

## Known failure modes

- Invalid IP format returns an error
- IPv6 addresses may not be supported (endpoint is IPv4-specific)
- Network timeout if blacklist databases are slow to respond
- Rate limiting if free tier quota is exceeded
- Private/reserved IP ranges may return unexpected results

## How this service works

Fast, reliable network tools API. IP geolocation, DNS lookup, SSL check, WHOIS, email validation, port scan. Free tier available.

## Output

Returns a JSON object containing the queried IP address, a boolean 'clean' flag indicating whether the IP is free of blacklist entries, and a 'listed_count' integer showing how many blacklists the IP appears on.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ip": "8.8.8.8",
  "clean": true,
  "listed_count": 0
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ipv4-fr-ip-blacklist-check-api-f439cbba/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from ipv4.fr](https://www.zero.xyz/host/ipv4.fr/llms.txt)
