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

Practitioner

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

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

Practitioner is a supporting FHIR resource about a person who is directly or indirectly involved in the provisioning of healthcare. This may be a doctor, a nurse, a social worker, or even IT personnel responsible for merging patient records. It even can be a dog (for example, a service animal such as a ward-assigned dog capable of detecting cancer in patients), which we think is pretty rad.

In contrast to many of the other resources in the Flexpa that are patient-specific, it serves as a foundational resource that supports the clinical and financial resources in the API. For instance, an ExplanationOfBenefit may contain a referenced Practitioner resource that is the provider who rendered the service.

As a result, Practitioner is most often used as part of an include parameter in a search request to retrieve the related resources or is accessed via a read with a specific FHIR resource ID obtained from a financial or clinical resource.

#Schema

This is Flexpa's supported FHIR schema for the Practitioner resource.

PropertyValueValue TypeData TypeDescriptionRequired
resourceType"Practitioner"FixedstringType of FHIR resource (fixed as "Practitioner")Yes
activetrue | falseEnumbooleanWhether the practitioner record is activeYes
gender"male" | "female" | "other" | "unknown"EnumstringAdministrative gender of the practitionerYes
metaobjectMetadata about the resourceYes
identifierobject[]Identifiers for the practitionerYes
nameobject[]A name associated with the practitionerYes
telecomobject[]Contact information for the practitionerYes
addressobject[]Physical address of the practitionerYes
qualificationobject[]Qualifications of the practitionerYes

Flexpa's Practitioner resource contains an aggregation of data from both the payer endpoint server and the official NPPES database.

Filter the top level arrays identifier, name, telecom, address, and qualification with the following function to include only NPPES data points:

function filterByOfficialNPPESData(element: Element) {
  return element.extension.some(
    (extension) => extension.extension.some(
      (extension) => extension.valueReference?.reference.startsWith('https://npiregistry.cms.hhs.gov')
    )
  );
}

const identifiers = practitioner.identifier.filter(filterByOfficialNPPESData);
const names = practitioner.name.filter(filterByOfficialNPPESData);
const telecoms = practitioner.telecom.filter(filterByOfficialNPPESData);
const addresses = practitioner.address.filter(filterByOfficialNPPESData);
const qualifications = practitioner.qualification.filter(filterByOfficialNPPESData);

#Sample request

This is a sample request using curl

ACCESS_TOKEN=flexpa-link-access-token

curl "https://api.flexpa.com/fhir/Practitioner" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

#Sample response

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

Status TwitterGitHub

© 2025 Flexpa. All rights reserved.

On this page
  • Schema
  • Sample request
  • Sample response