{"uid":"cap_Yy4F2139t2ODUNuLWbby2","slug":"oneshot-person-dossier-lookup-2fedbce2","name":"OneShot Person Dossier Lookup","description":"Tools, payments, and compute orchestration for autonomous AI agents.\n\n## Authentication\n\n- **`x402Payment`** — paid tool endpoints use the [x402 payment protocol](https://x402.io).\n First call returns `402 Payment Required` with a quote; sign and resend the request\n with `payment-signature: ` and `X-Quote-ID: `.\n- **`agentId`** — free read-only endpoints accept `X-Agent-ID: ` (0x… address).\n- **`soulKey`** — soul marketplace seller dashboard uses `Authorization: Bearer soul_…`\n (issued by `POST /v1/soul/register`).\n- **`acpBearer`** — Stripe ACP checkout sessions use a separate bearer token plus the\n `API-Version: 2026-01-30` header.\n\n## Async tools & polling\n\nMost tool endpoints return `202 Accepted` with `{ request_id, tool, status }`. Poll\n`GET /v1/requests/{id}` (with the same `X-Agent-ID`) to retrieve the final result.\nA WebSocket fallback is available at `wss:///v1/requests/subscribe`.\n\n## Pricing\n\nSee [docs.oneshotagent.com/pricing](https://docs.oneshotagent.com/pricing) for the full\ntable. Per-call prices for this environment:\n\n| Tool | Cost |\n|---|---|\n| Web search | $0.001 |\n| Web read | $0.002 |\n| Research | $0.01 |\n| Person profile | $0.005 |\n| Person email status | $0.001 |\n| Person dossier | $0.10 |\n| Person social accounts | $0.50 |\n| Business search | $0.01 |\n| Commerce search | $0.002 |\n| LinkedIn history sync | $0.02 per bounded run |\n| LinkedIn reply | $0.02 per message |\n| LinkedIn message to a connection | $0.02 per message |\n| LinkedIn profile view | $0.01 per view |\n| LinkedIn post reaction | $0.01 per reaction |\n| Email send | quote-based; service fee from $0.005 per send |\n| SMS send | $0.0035 per segment per recipient |\n| Voice call | $0.35/minute + $5.00 number registration on the first call |\n| Browser task | quote-based; minimum $0.005 |\n| Website build | quote-based; from $1.00 |\n| Compute goal | quote-based; minimum budget $1.00 + 20% platform fee |\n\n## Error format\n\n`{ \"error\": \"\", \"message\": \"\", \"details\": }`.\nValidation errors include a `details` field with the failing field paths.","url":"https://win.oneshotagent.com/v1/tools/lookup/person-dossier?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"name":{"type":"string","description":"Full name"},"email":{"type":"string","format":"email","description":"Email address"},"phone":{"type":"string","description":"Phone number"},"company":{"type":"string","description":"Employer name or domain, e.g. \"Coinbase\" or \"coinbase.com\""},"profile_url":{"type":"string","format":"uri","description":"Profile URL on LinkedIn, X or GitHub"},"linkedin_url":{"type":"string","format":"uri","description":"Same as profile_url (older name)"},"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 for up to one person; no phone hit is guaranteed."},"social_media_url":{"type":"string","format":"uri","description":"Same as profile_url (older name)"}}},"responseSchema":{"type":"json","example":{"result":{"posts":{"data":[],"state":"unavailable"},"profile":{"data":{"email":"jane@example.com","phone":null,"title":"Engineer","company":"Example","summary":null,"location":null,"full_name":"Jane Doe","last_name":"Doe","first_name":"Jane","linkedin_url":null,"company_domain":"example.com","social_accounts":[]},"state":"found"},"summary":"Only the profile was found; no additional account, article or post content was found.","articles":{"data":[],"state":"none"},"social_accounts":{"data":[],"state":"none"}},"status":"completed","request_id":"uuid","completed_at":"2026-10-14T10:00:00Z"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm__Tp_tm_StIho189sPy3W5","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a comprehensive person dossier including enriched profile, social accounts, articles, and posts given a name, email, company, or social URL.","exampleAgentPrompt":"Pull up a full dossier on Jane Doe at jane@example.com who works at Acme Corp — include her social accounts and articles, and also look up her phone number.","exampleUseCases":[{"title":"Pre-meeting contact research","prompt":"Before my call with Michael Chen at Stripe, can you pull a full dossier on him — his LinkedIn is linkedin.com/in/michaelchen — I want his title, social accounts, and any recent articles he's written."},{"title":"Sales lead enrichment","prompt":"I have a lead named Sarah Williams with email sarah@techcorp.io — can you enrich her profile with her job title, company details, social media accounts, and phone number if available?"},{"title":"Background check on new hire","prompt":"Can you compile a dossier on Alex Rivera who applied for our engineering role? Their Twitter is twitter.com/alexrivera_dev and they listed Vercel as their current employer."}],"resultDescription":"A JSON object with a `result` containing: a `profile` section (name, email, phone, title, company, location, LinkedIn URL, company domain, social accounts), a `social_accounts` section, an `articles` section, a `posts` section, and a plain-English `summary` of what was found. Each section includes a `state` field (found/unavailable/none) and a `data` array. Also returns `status`, `request_id`, and `completed_at`.","failureModes":["Person not found — profile state returns 'unavailable' with empty data","No phone number available even with include_phone=true — phone field is null, not guaranteed","Insufficient identifying information provided — lookup may return partial results","Rate limiting or payment failure via x402 — 402 returned if payment signature is missing or invalid","Async delay — initial call returns 202 with request_id; result must be polled via GET /v1/requests/{id}"],"whenToPreferThis":"Use this endpoint when you need a comprehensive, multi-dimensional person profile in a single call — combining professional enrichment (title, company, email), social account discovery, articles, and posts. Prefer this over narrower sibling endpoints (like the social posts or social interactions endpoints) when you want a full dossier rather than a single data type. Best suited for sales intelligence, pre-meeting research, lead enrichment, or background due diligence on individuals.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-16T12:36:40.495Z","isFirstParty":false,"canonicalSlug":"oneshot-person-dossier-lookup-2fedbce2"}