# Ava developer documentation

Ava Ecosystem is the developer portal for building public SMART on FHIR apps (EHR launch, authorization code + PKCE S256, FHIR R4) against Ava EMR. Each page below is raw markdown; /docs/llms-full.txt is the whole corpus in one file.

## Getting started

- [Quickstart](https://www.avaecosystem.ca/docs/quickstart.md): Register a sandbox app and make your first FHIR request in minutes.
- [Integration brief](https://www.avaecosystem.ca/docs/integration-brief.md): The whole Ava FHIR API contract condensed to one page — ideal context for a coding agent.

## Guides

- [App launch & PKCE](https://www.avaecosystem.ca/docs/guides/app-launch-and-pkce.md): Every request in the EHR launch flow — discovery, authorization code, PKCE S256, token exchange, and the launched patient context.
- [Scopes & permissions](https://www.avaecosystem.ca/docs/guides/scopes-and-permissions.md): SMART v2 scope grammar, patient vs user context, permission schemas, rationales, and re-consent.
- [Sandbox & test data](https://www.avaecosystem.ca/docs/guides/sandbox-and-test-data.md): What the synthetic sandbox is, the ontario_primary_care_v1 dataset, sandbox logins, and how sandbox differs from production.
- [Search & pagination](https://www.avaecosystem.ca/docs/guides/search-and-pagination.md): searchset Bundles, universal parameters, cursor pagination with _page_token, and what search deliberately does not support.
- [Writing documents & media](https://www.avaecosystem.ca/docs/guides/writing-documents-and-media.md): The create-only write surface — attaching DocumentReference and Media resources to the chart.
- [Errors & troubleshooting](https://www.avaecosystem.ca/docs/guides/errors-and-troubleshooting.md): OperationOutcome anatomy, OAuth error codes, HTTP status meanings, and the classic failure modes with fixes.
- [Going to production](https://www.avaecosystem.ca/docs/guides/going-to-production.md): The security review, production registration, and the independent marketplace listing review.

## Concepts

- [Clinic partitions](https://www.avaecosystem.ca/docs/concepts/partitions.md): Why every FHIR base URL contains a partition id, and what that means for your app.
- [Environments](https://www.avaecosystem.ca/docs/concepts/environments.md): Sandbox and production are separate registrations, clients, and data — and what carries over between them.
- [The review pipeline](https://www.avaecosystem.ca/docs/concepts/review-pipeline.md): How versioned snapshots, security review, production approval, and marketplace review relate — and why they're independent.

## API reference

- [API reference](https://www.avaecosystem.ca/docs/reference.md): Every implemented FHIR resource, with scopes, search parameters, and examples.
- [Authorization](https://www.avaecosystem.ca/docs/reference/authorization.md): SMART discovery, endpoints, PKCE requirements, and the scope grammar.
- [Patient](https://www.avaecosystem.ca/docs/reference/patient.md): Demographics and identifiers for a person receiving care.
- [Practitioner](https://www.avaecosystem.ca/docs/reference/practitioner.md): A clinician or other professional involved in care delivery.
- [PractitionerRole](https://www.avaecosystem.ca/docs/reference/practitioner-role.md): A practitioner's roles, specialties, and locations within an organization.
- [Organization](https://www.avaecosystem.ca/docs/reference/organization.md): A clinic, practice group, or other healthcare organization.
- [Location](https://www.avaecosystem.ca/docs/reference/location.md): A physical place where care is delivered.
- [Appointment](https://www.avaecosystem.ca/docs/reference/appointment.md): A booked or proposed visit between a patient and practitioners.
- [Encounter](https://www.avaecosystem.ca/docs/reference/encounter.md): An interaction between a patient and the care team — a visit.
- [Observation](https://www.avaecosystem.ca/docs/reference/observation.md): Measurements and findings — vitals, laboratory results, and similar.
- [Condition](https://www.avaecosystem.ca/docs/reference/condition.md): Problems, diagnoses, and health concerns on the patient's record.
- [AllergyIntolerance](https://www.avaecosystem.ca/docs/reference/allergy-intolerance.md): Allergies and intolerances recorded for the patient.
- [ServiceRequest](https://www.avaecosystem.ca/docs/reference/service-request.md): An order or referral for a procedure, test, or service.
- [MedicationRequest](https://www.avaecosystem.ca/docs/reference/medication-request.md): Prescriptions and medication orders for the patient.
- [FamilyMemberHistory](https://www.avaecosystem.ca/docs/reference/family-member-history.md): Health events in the patient's family history.
- [DocumentReference](https://www.avaecosystem.ca/docs/reference/document-reference.md): Write a document — a report, note, or file — onto the patient's chart.
- [Media](https://www.avaecosystem.ca/docs/reference/media.md): Write an image, video, or audio capture onto the patient's chart.

## Changelog

- [Changelog](https://www.avaecosystem.ca/docs/changelog.md): Developer-visible changes to the API, sandbox, and portal, newest first.
- [Versioning policy](https://www.avaecosystem.ca/docs/versioning-policy.md): What you can rely on, what counts as breaking, and the deprecation windows Ava commits to.