Skip to main content

Developers · API & SDK

Build on Suavo's delivery infrastructure.

Enterprise API, Fleet Operator SDK, webhooks, and OAuth 2.0. Access is granted per-contract today — public self-serve docs land Q3 2026 alongside the v1 SDK release. Until then: email us with your use case and we scope the integration directly.

Surface area

Four developer surfaces.

Enterprise API

REST + webhooks for multi-location chains and hospital networks. OAuth 2.0 authorization.

  • POST /v1/pharmacies — register a location
  • POST /v1/prescriptions — queue a delivery
  • GET /v1/deliveries/:id — track status + chain-of-custody events
  • POST /v1/webhooks — register delivery-event webhooks

Fleet Operator SDK

White-label fleet tooling. Build your own operator branding on top of Suavo's compliance + dispatch rails.

  • React Native driver components (MIT-licensed skeleton)
  • Rate-card introspection + commission reconciliation
  • Exception feed subscription (cold-chain, handoff failures)
  • Fleet-operator dashboard embed (iframe or headless)

Webhooks

Delivery lifecycle, custody transfers, exceptions, temperature excursions, writeback confirmations.

  • delivery.created · delivery.dispatched · delivery.picked-up
  • custody.handoff-signed · custody.patient-verified
  • temperature.excursion · cold-chain.break
  • writeback.completed · writeback.failed

OAuth 2.0

Third-party app authorization with scoped access tokens. Signed with asymmetric keys.

  • authorization_code + PKCE for web apps
  • client_credentials for server-to-server
  • scope restrictions at the pharmacy or fleet level
  • token rotation + audit logging

Public docs · roadmap

Self-serve OpenAPI + TypeScript SDK · Q3 2026.

Until then, integrations@suavollc.com. We'll grant sandbox access within one business day and map the integration scope on the first call.