API integrations — REST, MCP, discovery

Use when the user asks “is there an API?”, “how do I integrate?”, or wants endpoint names without reading the full OpenAPI blob.

Surfaces

Surface	URL	Notes
REST API	`https://411data.io/api/v1/…`	Bearer `411_…` or `411k_…`; paid routes debit virtual balance → 402 x402
MCP	`https://411data.io/mcp`	Same routes as tools; see /mcp.json
OpenAPI	/openapi.json	Full spec (large)
Compact route index	`GET /api/v1/openapi/routes?q=`	Free; filter by path keyword (agents, enrich, support, …)
Playground	/playground	Human-friendly try-it UI
Skill doc	/skill.md	LLM-oriented endpoint summary

Auth

Mint wallet-bound bearer: /connect or POST /api/v1/agents/wallet-nonce → wallet-register.
Scoped automation key: /connect?action=usagekeys.

Paid enrichment (live)

POST /api/v1/enrich/phone — reverse phone lookup ($0.330)
POST /api/v1/enrich/person — person search ($0.500)
POST /api/v1/enrich/websearch — LLM business-name hunt ($1.00 min; 30% markup when COGS > $1)
POST /api/v1/enrich/lead-session — multi-tool CRM lead hunt ($1.500 base + usage true-up)
POST /api/v1/enrich/jobs — async queue for websearch / lead-session (bill up to $1.50 default, override to $50; poll free)
GET /api/v1/enrich/jobs/{job_id} — poll async job (requires poll_bearer or owning agent bearer)
POST /api/v1/support/tickets — open support thread ($0.010; category: bug → $1.00 credit after confirmation)

Catalog routes (offline by default)

POST /api/v1/enrich/email, /company, and /leads/search return 503 until operator enables CATALOG_ROUTES_ENABLED=1. Cookbook recipes remain for reference.

Platform (selected free routes)

GET /api/v1/agents/me, /balance
POST /api/v1/support/tickets — open support thread ($0.01; bug → $1 credit); see support_tickets
GET /api/v1/event-callbacks/catalog — webhook event types
POST /api/v1/event-callbacks/subscriptions — create webhook (admin bearer)

Not available

Streaming / SSE on enrich responses — use event_callbacks or async job callback_url.
CSV batch upload — POST /api/v1/batch/enrich/upload and /batch; see batch_csv_enrich. Headless parallel REST: batch_and_concurrency.
Dedicated “file support ticket” Connect page — use enrich chat or POST /api/v1/support/tickets; see support_tickets.

Discovery tip for agents

cookbook_search → cookbook_read for question-shaped recipes; openapi_route_lookup?q= for path-shaped questions.

connect_wizards — account UI deep links
/developers — authoritative REST guide