Flexpa
Developer PortalFeedbackContact usOnboard

Guides

  • Home
  • Quickstart
  • Financial Data

Network

  • Network guide
  • Directory
  • Updates

Consent

  • Link SDK
  • Patient access

Records

  • FHIR API
  • Node SDK
  • FHIR Introduction
  • Usage
  • Terminology
    • AllergyIntolerance
    • Bundle
    • CarePlan
    • CareTeam
    • Condition
    • Coverage
    • Device
    • DiagnosticReport
    • DocumentReference
    • Encounter
    • ExplanationOfBenefit
    • Goal
    • Immunization
    • Location
    • Medication
    • MedicationDispense
    • MedicationRequest
    • Observation
    • OperationOutcome
    • Organization
    • Patient
    • Practitioner
    • PractitionerRole
    • Procedure
    • Provenance

Misc

  • Changelog
  • Support
  • Flexpa OS
  • We're hiring

Encounter

GET https://api.flexpa.com/fhir/Encounter

  • Encounter is a base FHIR Resource ( JSON example)
  • Commonly available via US Core Encounter Profile

Encounter is a administrative FHIR Resource to record an interaction between a patient and healthcare providers for the purpose of providing healthcare services or assessing the health status of a patient.

Accessing a patient's encounter can aid in workflows such as understanding a patient's history of care and identifying gaps in care.

Many payers make this available in a basic form derived from a patient's claims, but some also provide a more detailed view of the patient's encounters if they have a more robust provider-payer clinical data exchange, such as quality measures.

#Search parameters

The full list of search parameters can be found here. Some of the most important are:

Parameters

patientstring

The ID of the patient who participated in the encounter. We recommend using this search parameter along with the $PATIENT_ID wildcard

datestring

The date of the encounter.

typestring

The type of the encounter.

#Sample request

While some servers may support a resource-level search without any parameters, not all do. We recommend using the format below with the patient ID via the $PATIENT_ID wildcard as a search parameter.

This is a sample request using curl

ACCESS_TOKEN=flexpa-link-access-token

curl "https://api.flexpa.com/fhir/Encounter?patient=$PATIENT_ID" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

#Sample response

This is a sample response from UnitedHealthcare using Flexpa API in test mode

Status TwitterGitHub

© 2025 Flexpa. All rights reserved.

On this page
  • Search parameters
  • Sample request
  • Sample response