# OneShot Agent - Person Finder

> OneShot Agent - Person Finder is a paid API for AI agents from win.oneshotagent.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-16).

Search for people by name or query, returning contact and profile data, with optional phone number lookup.

## Facts

- Endpoint: POST https://win.oneshotagent.com/v1/tools/find/person?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/oneshot-agent-person-finder-73adedf8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_5E96HMdMEJpAte3KRgPTb

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 oneshot-agent-person-finder-73adedf8 -d '<json body>'
```

Example prompt: Find contact information for Jane Smith, the VP of Marketing at Acme Corp — and include her phone number if possible.

## When to prefer this

Use this endpoint when you need to find or enrich contact data for a specific person by name or description, especially when you need phone numbers in addition to basic profile info. Prefer it over company search when targeting an individual rather than an organization, and over email enrichment when you don't already have an email address to start from. Best for sales prospecting, recruiting outreach, journalism research, or any workflow where identifying and contacting a real person is the goal.

## Known failure modes

- Person not found — query too vague or individual not in database
- 402 Payment Required on first call — must sign and resend with x402 payment signature and quote ID
- Phone lookup returns no results — phone numbers not guaranteed even with include_phone=true
- Polling times out — result may take longer than expected for large result sets
- Invalid query format — missing or malformed query string returns 400 error
- Rate limit or quota exceeded — too many requests in a short period

## How this service works

Tools, payments, and compute orchestration for autonomous AI agents.

## Authentication

- **`x402Payment`** — paid tool endpoints use the [x402 payment protocol](https://x402.io).
  First call returns `402 Payment Required` with a quote; sign and resend the request
  with `payment-signature: <base64 x402 payment>` and `X-Quote-ID: <quote_id>`.
- **`agentId`** — free read-only endpoints accept `X-Agent-ID: <wallet>` (0x… address).
- **`soulKey`** — soul marketplace seller dashboard uses `Authorization: Bearer soul_…`
  (issued by `POST /v1/soul/register`).
- **`acpBearer`** — Stripe ACP checkout sessions use a separate bearer token plus the
  `API-Version: 2026-01-30` header.

## Async tools & polling

Most tool endpoints return `202 Accepted` with `{ request_id, tool, status }`. Poll
`GET /v1/requests/{id}` (with the same `X-Agent-ID`) to retrieve the final result.
A WebSocket fallback is available at `wss://<host>/v1/requests/subscribe`.

## Pricing

See [docs.oneshotagent.com/pricing](https://docs.oneshotagent.com/pricing) for the full
table. Per-call prices for this environment:

| Tool | Cost |
|---|---|
| Web search | $0.001 |
| Web read | $0.002 |
| Research | $0.01 |
| Person profile | $0.005 |
| Person email status | $0.001 |
| Person dossier | $0.10 |
| Person social accounts | $0.50 |
| Business search | $0.01 |
| Commerce search | $0.002 |
| LinkedIn history sync | $0.02 per bounded run |
| LinkedIn reply | $0.02 per message |
| LinkedIn message to a connection | $0.02 per message |
| LinkedIn profile view | $0.01 per view |
| LinkedIn post reaction | $0.01 per reaction |
| Email send | quote-based; service fee from $0.005 per send |
| SMS send | $0.0035 per segment per recipient |
| Voice call | $0.35/minute + $5.00 number registration on the first call |
| Browser task | quote-based; minimum $0.005 |
| Website build | quote-based; from $1.00 |
| Compute goal | quote-based; minimum budget $1.00 + 20% platform fee |

## Error format

`{ "error": "<machine_code>", "message": "<human readable>", "details": <optional> }`.
Validation errors include a `details` field with the failing field paths.

## Output

Returns a 202 Accepted with a request_id and status 'processing'. The agent must poll GET /v1/requests/{id} (with the same X-Agent-ID header) or subscribe via WebSocket to retrieve the final person search results, which include profile data and optionally phone numbers for matched individuals.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "query": {
   "type": "string",
   "description": "Person search query"
  },
  "include_phone": {
   "type": "boolean",
   "default": false,
   "description": "Phone lookup is off by default. include_phone=true adds the per-person add-on on the pricing page × requested limit (default 100) for up to that many people; no phone hit is guaranteed."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "status": "processing",
  "request_id": "uuid"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/oneshot-agent-person-finder-73adedf8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from win.oneshotagent.com](https://www.zero.xyz/host/win.oneshotagent.com/llms.txt)