Credential contract
Use one Synorb Key as a Bearer token for REST and MCP. /connect self-provisions a 24 Hour Agent Demo key with no email, 1,000 Manifests, and expires_at in the payload; it expires after 24 hours. Bind an email at /api/connect/bind-email to upgrade the same key to Starter, free forever. Individual is $10/month for 10,000 Manifests.
Authorization: Bearer YOUR_SYNORB_KEYProvenance is part of the answer
Source. Every Manifest carries its source URL and publisher metadata. Preserve both in the buyer-facing result.
Unit. Billing is per item delivered, so usage has a predictable unit economics model you can pass to your buyer.
Scope. The 54-surface taxonomy and plan mode let you prove the requested scope before spending anything.
Plan before execution
Use plan mode to show the surfaces and expected scope, then execute only the reviewed request.
POST https://api.synorb.com/manifests/query
Authorization: Bearer YOUR_SYNORB_KEY
Content-Type: application/json
{"mode":"plan","required_surfaces":["public_companies","private_companies"],"page_size":10}Handle errors in code
Error states are explicit and machine-readable. Rate limits return retry_after. Entitlement failures name the failure. Expired keys return a recovery path: mint a new 24 Hour Agent Demo key at /connect or sign up free at /signup. Do not turn any of these states into an unqualified empty answer.