# 402Forge Relocation Decision API

> 402Forge Relocation Decision API is a paid API for AI agents from geo-seo-forge.donneash.workers.dev, paid per call via x402, $0.08/call, status unknown (last checked 2026-10-27).

Recommends a relocation destination based on user priorities and family context, returning a city recommendation with rationale and confidence score

## Facts

- Endpoint: POST https://geo-seo-forge.donneash.workers.dev/decide/relocation?utm_source=zero.xyz
- Price: $0.08/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-27
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/402forge-relocation-decision-api-908b82c4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Ee5Fow5xL_w16CZwCJ44b

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 402forge-relocation-decision-api-908b82c4 -d '<json body>'
```

Example prompt: My family of 3 prioritizes good schools above everything else — can you recommend the best city for us to relocate to and explain why?

## When to prefer this

Choose this endpoint when an agent needs a concrete, AI-driven city recommendation for relocation with an accompanying rationale and confidence score — especially when family size and ranked priorities (like schools, cost of living, climate) are known inputs. Prefer this over generic search or map APIs when the goal is a decisive recommendation rather than a list of options.

## Known failure modes

- HTTP 402 returned if payment is not included — requires valid x402 payment header before content is served
- Missing or malformed priority/family_size fields may result in low-confidence or generic recommendations
- Cloudflare Worker cold-start latency on first request
- Unsupported priority combinations may yield low confidence scores
- Network timeout if Worker is under load

## How this service works

Paid x402 routes only (HTTP 402 without payment). Free Election Integrity preview is not listed here: GET /v1/e/ei/card. Full doc: /openapi-full.json. Contact email for merchant ownership verification.

## Output

A JSON object containing a recommended city name (e.g. 'alpharetta'), a human-readable rationale explaining how the priorities and family context drove the recommendation, and a confidence score between 0 and 1 indicating how strongly the model favors that destination.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "priority": {
   "enum": [
    "balanced",
    "schools",
    "commute",
    "luxury"
   ],
   "type": "string"
  },
  "budget_usd": {
   "type": "integer",
   "description": "Housing budget USD"
  },
  "family_size": {
   "type": "integer",
   "description": "Household size"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "rationale": "Priority=schools; family_size=3",
  "confidence": 0.88,
  "recommendation": "alpharetta"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/402forge-relocation-decision-api-908b82c4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from geo-seo-forge.donneash.workers.dev](https://www.zero.xyz/host/geo-seo-forge.donneash.workers.dev/llms.txt)