Overview & Authentication - SANNOS Partner API

The Partner API uses a two-tier API key authentication model:

Tier	Key Type	Scope	Used For
1	Partner Key	Partner organization	Onboarding clients, listing companies, browsing controls
2	Company Key	Single client company	Document submission, status polling, results retrieval

Lifecycle:

Setup Phase (One-time):
  SANNOS Admin ──> Create Partner + Generate Partner API Key
  SANNOS Admin ──> Deliver Partner API Key (secure channel) ──> Partner

Integration Phase (Per-Client):
  Partner ──POST /v2/onboard (Partner Key)──> API
  Partner <── Company API Key (shown once) ── API

Operational Phase (Per-Document):
  Partner ──POST /v2/documents/submit (Company Key)──> API
  Partner ──GET /v2/documents/{id}/status (Company Key)──> API
  Partner ──GET /v2/documents/{id}/result (Company Key)──> API

Error codes: see the Error Codes guide.