# agentfetch /v1/headers

> agentfetch /v1/headers is a paid API for AI agents from agentfetch.dynv6.net:8080, paid per call via x402, $0.005/call, status down (last checked 2026-09-16).

Fetches HTTP response headers and metadata for a given URL, including status code, redirect chain, and server info, paid via USDC micropayment.

## Facts

- Endpoint: GET https://agentfetch.dynv6.net:8080/v1/headers
- Price: $0.005/call
- Payment: x402
- Status: down
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentfetch-v1-headers-84ab0509
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_vNQj0mXWgxc_Nado7hDCf

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 agentfetch-v1-headers-84ab0509
```

Example prompt: Can you check the HTTP response headers for https://example.com — I want to know the status code, server type, any redirects, and how long it took to respond?

## When to prefer this

Use this endpoint when you need lightweight HTTP metadata about a URL without downloading the full page body — ideal for checking server type, status, redirects, and response time cheaply. Prefer this over page-to-markdown or screenshot endpoints when you only need header-level information. Best for monitoring, infrastructure checks, redirect auditing, or CDN/server detection tasks.

## Known failure modes

- URL is unreachable or times out — likely returns an error status or non-200 code
- Invalid or malformed URL input — may return a 4xx error from the API itself
- Target server blocks automated requests — may return 403 or unusual headers
- DNS resolution failure for the provided domain — endpoint returns an error
- Payment not processed (x402 flow fails) — request is rejected before being made

## How this service works

Pay-per-call web utilities for AI agents: page metadata, page-to-markdown (optional JS rendering), and PNG screenshots. USDC micropayments on Base or Solana via x402.

## Output

Returns a JSON object containing the final URL, HTTP status code, response headers as key-value pairs, the number of redirects followed, the redirect chain (if any), and elapsed response time in milliseconds.

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "url": "https://example.com",
  "chain": [],
  "status": 200,
  "headers": {
   "server": "nginx"
  },
  "elapsedMs": 120,
  "redirects": 1
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentfetch-v1-headers-84ab0509/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentfetch.dynv6.net:8080](https://www.zero.xyz/host/agentfetch.dynv6.net%3A8080/llms.txt)
