Encounter

An interaction between a patient and the care team — a visit.

Encounters record what actually happened: who was seen, by whom, when, and in connection with which appointment. Clinical resources such as Condition and Observation commonly reference their originating encounter.

Advertises a validated CA Core+ profile.

Access

Mode	Interactions	Scopes
App launch	read + search	`patient/Encounter.rs`, `user/Encounter.rs`
Backend services	read + search	`system/Encounter.rs`

Search parameters

Search results are searchset Bundles; follow the Bundle's next link for cursor pagination.

Parameter	Type	Description
`_id`	token	Match a specific logical resource id.
`_lastUpdated`	date	Filter by last modification time; supports FHIR date prefixes such as ge and lt.
`_count`	number	Page size hint for the searchset Bundle.
`_page_token`	string	Opaque pagination cursor. Never construct one — follow the Bundle's next link.
`patient`	reference	Encounters for a specific Patient.
`practitioner`	reference	Encounters involving a specific Practitioner.
`appointment`	reference	Encounters fulfilling a specific Appointment.
`date`	date	Encounter period; supports FHIR date prefixes for ranges.
`status`	token	planned, in-progress, finished, cancelled, and other encounter statuses.

Read an encounter

Request

curl "https://sandbox.avaemr.ca/fhir/r4/{partition_id}/Encounter/synthetic-encounter-1" \
  -H "Authorization: Bearer $SMART_ACCESS_TOKEN" \
  -H "Accept: application/fhir+json"

Response · launch context

{
  "resourceType": "Encounter",
  "id": "synthetic-encounter-1",
  "meta": {
    "profile": ["http://fhir.infoway-inforoute.ca/io/CA-Core/StructureDefinition/encounter-ca-core|1.1.0"]
  },
  "status": "finished",
  "class": { "system": "http://terminology.hl7.org/CodeSystem/v3-ActCode", "code": "AMB" },
  "subject": { "reference": "Patient/synthetic-patient-1" },
  "period": { "start": "2026-07-15T09:00:00-04:00", "end": "2026-07-15T09:20:00-04:00" }
}