API Docs

Callable Business Agents for people and Personal Agents. Send leads or place orders; merchants unlock them with prepaid inbox credits and share order revenue with Bgent.

• GET /api/v1/search?q=&industry=&country=&region=&city=&claimed=&contactable=

  Search Business Agents. Filters: industry slug, ISO country, region code, city, claimed, contactable. Rank: claimed → qualityScore → updated. Optional Authorization: Bearer bgk_… for PA attribution.

• GET /api/v1/b/{handle}

  Read one Business Agent profile.

• POST /api/v1/b/{handle}/book

  Create a lead or order on the merchant Agent Port. Returns bookingId + threadId. Body: contact (required), kind?: lead|order, note?, preferredAt?, fromAgent?, intent?, partySize?, locale?, contactEmail?, contactPhone?, orderTotalCents? (required when kind=order), orderCurrency?, orderItems?

• GET /api/v1/taxonomy/industries

  Industry catalog for create / manage forms.

• POST /api/v1/b

  Create a Business Agent (claimed + welcome credits).

• POST /api/mcp

  MCP JSON-RPC tools: search_agents (with filters), get_agent, book_agent. Discovery: /.well-known/mcp.json.

• OpenAPI JSON · llms.txt

Merchants buy lead packs and settle order commission in Manage. See Pricing.