ERA FHIR specification
1.0.0 - draft

ERA FHIR specification - Local Development build (v1.0.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

OperationDefinition: AppointmentFi Search From Kanta

Official URL: https://eradocumentation.atostek.com/OperationDefinition/Appointment-search-from-Kanta Version: 1.0.0
Draft as of 2026-10-28 Computable Name: search-from-Kanta

The operation can be used to search for appointments from the Kanta Patient Data Repository.

The operation requires an active ERA session and the client registry ID. Please provide these in the request header.

URL: [base]/Appointment/$search-from-Kanta

Parameters

UseNameScopeCardinalityTypeBindingDocumentation
INpatientIdentifier1..1Identifier

patient.identifier - Identifier of the patient who is the subject of the appointment.

INidentifier0..1Identifier

appointment.identifier - Business identifier of the appointment.

INserviceOrganiser0..1Coding

Provenance.agent.who.identifier - Organiser of the booked service.

INappointmentServiceProvider0..1Coding

organization.partOf.identifier - Provider of the booked service. For social and health care organizations, the Kanta code system '1.2.246.537.6.202.2008' and a valid code value should be provided. For independent practitioners, use Kanta code system '1.2.246.537.6.203.2014'.

INappointmentServiceProviderUnit0..1Coding

organization.identifier - Organization where the booked service takes place. For social and health care organizations, the Kanta code system '1.2.246.537.6.202.2008' and a valid code should be provided. For independent practitioners, use Kanta code system '1.2.246.537.6.203.2014'.

INproducingServiceProviderUnit0..1Coding

Provenance.agent.who.identifier - Organization that produced the Appointment resource. If this parameter is provided, the service provider parameter 'appointment-service-provider' must also be provided (in addition to the patient identifier). For social and health care organizations, the Kanta code system '1.2.246.537.6.202.2008' and a valid code should be provided. For independent practitioners, use Kanta code system '1.2.246.537.6.203.2014'.

INdate0..2string

appointment.start – Start time of the appointment. The accepted date formats are yyyy-mm-dd, yyyy-mm-ddThh:mm:ss or yyyy-mm-ddThh:mm:ss[Z|(+|-)hh:mm]. A value entered without a time zone is treated as the Helsinki time zone. Mandatory prefix options include eq, gt, lt, ge, le. When two dates are provided, they must not include the eq prefix. The eq prefix can only be used with a single date.

INrecorded0..2string

provenance.recorded - Creation time of the appointment, i.e. the moment when the Appointment resource was created. The accepted date formats are yyyy-mm-dd, yyyy-mm-ddThh:mm:ss or yyyy-mm-ddThh:mm:ss[Z|(+|-)hh:mm]. A value entered without a time zone is treated as the Helsinki time zone. Mandatory prefix options include eq, gt, lt, ge, le. When two recorded are provided, they must not include the eq prefix. The eq prefix can only be used with a single recorded.

INregisterTypeCode0..1Coding

provenance.extension.RegisterType - Patient register identifier.

INserviceEvent0..1string

provenance.extension.ServiceEvent - Service event identifier used as a search filter.

INdisclosureServiceEventId0..1string

Disclosure service event identifier. This parameter must be provided if performing a disclosure search.

INincludeOwn0..1boolean

Whether the search result should return data from the inquirer’s own register or exclude it (default: true).

INcount0..1integer

Maximum number of search results to return in one response. When continuing a paged search, provide resultSetKey and originalXRequestId along with the same count value as in the previous search request.

INresultSetKey0..1Identifier

Result set identifier used for continuing a paged appointment search. This parameter must be provided together with originalXRequestId and count. Omit both resultSetKey and originalXRequestId when starting a new search.

INoriginalXRequestId0..1string

Original X-Request-ID used for continuing a paged appointment search. This parameter must be provided together with resultSetKey and count. Omit both resultSetKey and originalXRequestId when starting a new search.

INconfirmed-protected-content0..*

Codes of protected contents views that are included in the search result, and information on whether viewing the protected content has been confirmed automatically. The user must be asked for separate confirmation before showing protected content unless viewing that content has been separately defined as part of the user's work tasks.

INconfirmed-protected-content.content1..1Codingfipta-vs-tableofcontentsprotected (Required)

The value must be from ValueSet fipta-vs-tableofcontentsprotected.

INconfirmed-protected-content.automatic0..1boolean

Whether viewing the protected content has been confirmed automatically without asking the user. The default value is false.

INconfirmed-protected-content.reason0..1string

Optional free-text reason for showing the protected content.

OUTreturn1..1Bundle

Appointment and Provenance (appointment meta information) resource pairs that matched the given search parameters. If search results were filtered because of protected content, the response Bundle also contains an OperationOutcome that describes which protected table of contents views were omitted from the result.