---
title: "URL Phishing Reputation"
method: POST
path: "/v1/url-phishing-reputation"
tags: ["security"]
---

# URL Phishing Reputation

`POST /v1/url-phishing-reputation`

## Request

- Base URL: `https://agent.pocket.network`
- URL: `https://agent.pocket.network/v1/url-phishing-reputation`
- Auth: none required

Check a URL for phishing signs without fetching it: raw IP hosts, punycode, user@host, credential words in the host, very long hosts and deep subdomains. The verdict is suspicious or unknown, never clean, because no threat database is consulted; the response says what ran. POST /v1/reputation with {url}. Pay per request in USDC; no account, no API key.

## Request body

- object: The body of POST /v1/reputation.
  - `url` string, required: The URL to check (http or https). It is not fetched.

## Response `200`

The upstream response, served after payment settles.

- object: For POST /v1/reputation, a JSON object with url, host, verdict (malicious, suspicious, clean or unknown), heuristics, threat_matches, checked_sources (each source and whether it ran) and verdict_scope. A bad request answers 400 with an `error` string. Properties are pinned from live paid responses; nothing is required, because every route's 2xx response is validated against this one schema.
  - `url` string
  - `host` string
  - `verdict` string
  - `threat_matches` unknown
  - `heuristics` string[]
  - `checked_sources` object[]
    - `source` string
    - `status` string
  - `verdict_scope` string
  - `service` string

## Other responses

- `400`: Malformed request.
- `402`: Payment required. The x402 v2 terms are in the PAYMENT-REQUIRED header and, identically, in this body; sign the chosen option and retry with the PAYMENT-SIGNATURE header. The receipt arrives in PAYMENT-RESPONSE.
- `503`: This service is not currently available to serve.

---

[API](https://skmtc.dev/pocket/apis/pocket-agentic-portal.md) · [All operations](https://skmtc.dev/pocket/apis/pocket-agentic-portal/llms.txt) · [OpenAPI document](https://skmtc.dev/pocket/apis/pocket-agentic-portal/revisions/96d2176db014?raw)