# 411data

> Agent-native lead and business-data enrichment API. Mint a wallet-bound agent at /connect (~$0.20 starting virtual USD balance); x402 v2 on Base mainnet kicks in only after the virtual balance reaches $0. Hosted enrich agent at /enrich_agent + REST + OpenAPI + Bazaar discovery.

## Scope discipline (read first)

411data enriches **phones, people, and business leads** via reverse phone lookup,
person search, LLM web-search, and agentic lead-session orchestration. Every request/response
is stored for audit. When answering enrichment questions, use **only** data
returned by these tools. If a tool returns no match or an error, say so plainly
— **do not invent contact records**. Bill-on-match routes auto-refund when no
usable result is found.

## Quick setup

- Hosted enrich agent (chat UI): https://411data.io/enrich_agent
- Quick start (humans): https://411data.io/quickstart
- Skill file (REST catalog, billing): https://411data.io/skill.md
- OpenAPI 3.1 paid catalogue (`x-payment-info`): https://411data.io/openapi.json
- OpenAPI 3.1 free surface (mint, account): https://411data.io/openapi-free.json
- x402 catalog: https://411data.io/.well-known/x402
- Bazaar discovery: https://411data.io/discovery/resources
- Agent card: https://411data.io/.well-known/agent-card.json

## Free account tools (bearer required)

- `GET https://411data.io/api/v1/agents/me` — profile, balance, linked wallets
- `GET https://411data.io/api/v1/agents/balance` — virtual USD balance summary
- `GET https://411data.io/api/v1/keys` — list scoped usage keys (admin bearer only)

## Paid enrichment (virtual USD first, then x402)

- `$0.330` `POST /api/v1/enrich/phone` — `{phone}` — reverse phone lookup; bill-on-match
- `$0.500` `POST /api/v1/enrich/person` — `{name?, phone?, street?, city?, state_code?, zipcode?}` — person search; bill-on-match
- `$1.000` min `POST /api/v1/enrich/websearch` — `{business_name, city?, state?, domain?}` — LLM web-search; $1 min on match, 30% markup when COGS > $1; bill-on-match
- `$1.500` base `POST /api/v1/enrich/lead-session` — `{lead, budget_usd?, …}` — multi-tool CRM enrichment (+ usage true-up)
- Bill up to route default (`bill_up_to_usd` override to **$50**) `POST /api/v1/enrich/jobs` — `{route, payload, bill_up_to_usd?, callback_url?}` — async websearch, lead-session, or partial hunt ops (slot-rerun, slot-person, slots-rerun, synthesize-patch, …); virtual precharge with bearer, or CDP upto when anonymous
- Free `GET /api/v1/enrich/jobs/{job_id}` — poll with `poll_bearer` (`411j_…`) from the 202 body
- `$0.010` `POST /api/v1/support/tickets` — `{category, subject, body}` — open support thread; `category: bug` earns $1.00 virtual USD after operator confirmation

Catalog routes offline by default: `enrich/email`, `enrich/company`, `leads/search`.

## Cookbook (worked examples)

Free worked-example pages for common enrichment patterns:

- Index: https://411data.io/cookbook
- Meta: https://411data.io/cookbook/filter_discipline_meta
- When to use websearch: https://411data.io/cookbook/enrich_websearch_when
- Bill-on-match billing: https://411data.io/cookbook/bill_on_match
- Prepay USDC top-up: https://411data.io/cookbook/prepay_deposits
- Anti-recipe — do not invent data: https://411data.io/cookbook/anti_invent
- Async enrich jobs (virtual balance + CDP upto): https://411data.io/cookbook/async_enrich_jobs

## Long-form docs

- Quick start (human): https://411data.io/quickstart
- Example questions (enrich agent stress-test): https://411data.io/example-questions
- Enrich agent: https://411data.io/enrich_agent
- Developer guide (human): https://411data.io/developers
- About: https://411data.io/about
- Pricing: https://411data.io/pricing
- x402 policy: https://411data.io/x402
- Full machine doc with examples: https://411data.io/llms-full.txt