# WebFinger Lookup

> WebFinger Lookup is a paid API for AI agents from intel.rallylive.ca, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Resolves a WebFinger resource (acct:user@domain or URI) via RFC 7033 and returns subject, aliases, and links including ActivityPub actor, profile page, avatar, OIDC issuer, and remote-follow template.

## Facts

- Endpoint: GET https://intel.rallylive.ca/dev/webfinger
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/webfinger-lookup-2786eba5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_SGlIGc2zedbE4EoTmgI2V

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 webfinger-lookup-2786eba5
```

Example prompt: Look up the WebFinger record for @ev@mastodon.social and give me their ActivityPub actor URL, profile page, avatar, and any OIDC issuer or remote-follow template listed.

## When to prefer this

Choose this endpoint when you need to resolve a fediverse or decentralised identity (acct:user@domain or a resource URI) into its ActivityPub actor, profile, avatar, OIDC issuer, or remote-follow links without setting up your own WebFinger client. It is ideal for agents building federation flows, decentralised auth, or profile enrichment on top of Mastodon, Pixelfed, Misskey, or any RFC 7033-compliant server. Prefer it over raw HTTP fetches when you want a clean parsed JRD response with all relevant relations already extracted.

## Known failure modes

- Resource or domain not found: endpoint or /.well-known/webfinger returns 404
- Domain does not support WebFinger: connection refused or no well-known route
- Invalid acct: or URI format causes a 400-style error
- Target server timeout or network error during upstream resolution
- User exists but has no links of the requested relation type — empty links array returned

## How this service works

WebFinger lookup (RFC 7033): resolves acct:user@domain or a resource URI via /.well-known/webfinger and returns the subject, aliases, and links (ActivityPub actor, profile page, avatar, OIDC issuer, remote-follow template). Identity resolution for fediverse and decentralised-auth agents. $0.01 per lookup.

## Output

A JSON object containing the WebFinger JRD response: the canonical subject URI, an array of alias URIs, and a links array with typed relations such as the ActivityPub actor URL (rel=self), profile page, avatar image, OIDC issuer, and remote-follow template — following RFC 7033.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {}
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/webfinger-lookup-2786eba5/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from intel.rallylive.ca](https://www.zero.xyz/host/intel.rallylive.ca/llms.txt)