Getting Started With Zonda

Zonda exposes a set of REST APIs for integrating with the platform’s core healthcare and operational domains. The public API is organized by service, shares a common base URL, and operates in the organization context associated with the calling credentials.

Base API URL: https://api.zondahealth.com


Zonda // Organizations API

Organizations API manages organization-specific configuration. It exposes resources for insurers, plans, modules, procedures, prices, and rosters, allowing an integration to represent the services, commercial agreements, and operational availability of each organization.

Zonda // Patients API

Patients API manages organization-scoped patient data and care history. It exposes patient profiles, clinical records, prescriptions, surveys, and longitudinal clinical views, so integrations can create, retrieve, search, and update patient information through a consistent public contract.

Zonda // Management API

Management API manages care delivery operations at the organization level. Its public resources cover treatments, appointments, recurring schedules, and appointment attachments. Use it to coordinate planned care and the operational activity that feeds downstream settlement processes.

Zonda // Billing API

Billing API manages settlement configuration and processing alongside invoicing. It exposes settlement policies and policy versions, groups, geographic zones, cycles, runs, statements, adjustments, and invoices. Use it to configure settlement rules and integrate an auditable financial lifecycle around care activity.

Zonda // Catalog API

Catalog API exposes Zonda’s standardized healthcare reference data. Its public resources include professions, specialties, diagnoses, insurers, procedures, supplies, modules, and standard prices. Use it as the common master-data source when building or synchronizing an organization’s local configuration.

Zonda // Auth API

Auth API manages identity and organization access. Its public resources cover organization context, memberships and invitations, self-service account operations, and Personal Access Tokens (PATs). Use it to establish and manage the access context required by the rest of the Zonda APIs.


Authentication

All API calls must be authenticated with a Personal Access Token (PAT).

Getting a PAT

  1. Log in to the Zonda platform with an admin account. Only admins can create tokens.
  2. Open the Configuration panel.
  3. Create a new Personal Access Token and copy it. Tokens are prefixed with zpat_ (e.g. zpat_a1b2c3...).
⚠️

Store the token securely. Treat it like a password — anyone with the token can call the API on behalf of your organization.

Using the token

Pass the token in the Authorization header as a Bearer token:

Authorization: Bearer zpat_xxxxxxxxxxxxxxxx

Example

curl https://api.zondahealth.com/v1/patients \
  -H "Authorization: Bearer zpat_xxxxxxxxxxxxxxxx"

If the token is missing, invalid, or expired, the API returns 401 Unauthorized.